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With SPI’s built-in e-Commerce feature, distribute and sell your software in one easy step. 

Your nustomorfi .ciimply download your SPl protected product and select Purchase 
when they run the installer. After entering their credit card information, SFl uses 
identity autkeritkation, packet encryption and a secure link between SPl and the 
authorizing agent to protect the transaction. Upon authorization, your product is 
installed and ready to run. You can even set up a '*try^-bcfore-yoii-buy^' demo that 
can then be upgraded using SPFs e-Commerce feature when the demo expires. 

Features: 

‘ Real-Time Authorization thru CyberCash"^ or Authorize.Net'' No Web Stoie 
Front Required * S-tier TVansaction Protection * Upgrade Demos to Full Version 
from Original Product Installer Download * Purchase/Tk ackiiig Reports Provide 
Additional Credit Card C!;harge-Back Protection * Reduces Web Hosting Charges 

No special hardware required. 


SPl doesn't require expensive hardware keys or dongles to protect your software. Besides, 
you can't download a dongle. SPl uses an encrypted software lock to protect 
installed files. Once a legal product is installed, SPl’s Lock Point feature prevents 
illegal copies from running on any other computer, while SPPs uninstall feature 
allows end-users to move a pruiecLed product, io another computer. Simply run 
the installer again and SPl disables the first installation, allowing the software 
to be installed on another computer. 


See for yourself how SPl 
protects your products. 


Visit our web site at www.nwspi.com to request our SPl Evaluation Kit. The SPl 

Evaluation Kit will allow you to pro Led one of your software products for 
up to one month. Each Evaluation Kit comes complete with the cross-platform 
SPT software, APIs and the SPl User s Guide outlining all of SPi's features. 
You can test every feature of SPl, including the built-in e-Comincrce feature 
with a special merchant account set up just for testing purposes. Request 
your SPT Evaluation Kit today. 


Software Piracy intervention wwwMwspicom 
New Wave Software, Inc, 800-920-9283 info@nw$pLcQm 

Copyright ©i 1999 New Wave Sotiware. km All Riptits Ftesenred. PaL Pend, SPl is a lisdcmailt ol New Wawe Software, Inc. 

Cy-berCasti is 3 Ir^eirkiii1< al CyberCa^sh, Im Auttinrjze.NU is a tradennadc of Authorve.Nat Corporation 


SPl'tracks down software pirates 
with every Illegal click. 


SPl adds a protective layer to your program that allows only those end-users who legitimate¬ 
ly purchase your software to install it. No matter how many copies of your program get 
distributed illegally, only the valid puix:haser can install and run your product. 

For just pennies a copy, you can prottTCt all your products and significantly 
increase your revenue without increasing production costs. 

Features: 

• Win95, Win9d, Win2000, WinNT, Mac/PowerMae * Resource Encryption 

• Key File Encryption ^ 3 Built-in Demo Modes * Built-in Online Registration 

’ Built-in General Purpose Registers " Distribute via CD/DVD, Diskette, Internet 

Sell your software without 
a shopping cart. 











*^Wlih<mt a dimbty the Premiere Resource Editor 
for the Mae OS A wealth oftiine-saving tools*^ 

- MacUser Magazine. Eddy Awards 

“A disHnct improvement over Applets ResEdit ** 

-Maclhch Magazine 

""Every Mac OS developer should own a copy of Resorcerer'' 

- Leonard Rosenihol, Aladdin Systems 

""^Without Resorcerer^ our localizaikm efforts would look like a 
Tower of Babel. Dont do product without itr 

- Greg Galanos, CEO and President, Metrowerks 


""Resorcerer's data template system is amazing." 

- Bill Goodman, author of Smaller Installer and Compact Pro 

"Resorcerer Rocks! Buy it, you will NOT regret if 

- Joe Zobkiw, author of A Fragment of Your Imagination 

""Resorcerer will pay for itself m any times over in saved time and effort. 

- MacUser review 

""The template that disassembles "PICTs is awesome!" 

- Bill Steinberg, author ofPyro! and PBTools 

""Resorcerer proved indispensible in its own creation!" 

- Doug McKenna, author of Resorcerer 






Version 2.0 


The Resource Editor for the Mac™ OS Wizard 


ORDERING INFO 


Requires System 7.0 or greater, 
1.5M13 liAM, CD ROM 

Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PC's, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 

MATHEMi^:STHETTCS, TKC. 

PO Box 298 

Boulder, CO 80306-0298 USA 

Phone:(303)440-0707 

Fax: (303) 440-0504 

resorce rer@ m a th e m aesthe tic s. com 


• Very fast, IlFS browser for viewing file tree of ail volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 
■ New AppleScript Dictionary (^aete^) Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• FowerPlani text traits and menu command support 
» Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; it's easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez;-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit last Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Tnclude.s nearly 200 templates for common systera resources 

• TMPLs for installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• 'Fry out balloons, 1ctb*3, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


Tb order by credit c^ard, or to get the latest news, bug fixes, updates, and appreiiti<^eB, viBit our website-. 

www.mathemaesthetics.com 
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at mVm-9797 or fax us at 80 VW- 9798 - 

If you would like a subscription or need 
aisUJmer service, feel free to conUicl 
Develotier Depot Customer Service at 
800 ^MACDFV 4 


DEPARXTMLENTN 

Orders, Circulation, ik Cui^tomcr Service 
Presss Releases 
Ad S aks 
Editorktl 

PTograiiunei^s Clialleiiige 

Online Support 

Accounting 

Marketing 

General 

Well Site (articles, info, I JRI.s and niore^O 


KMaU/LIRL 

cu st_^ervice@ maciech .com 
pi es,s_TeleiLses@mactech .com 
ad_sale.H@m^ic ted i .com 
cditorial@mactcchcom 
prc>gj hal lengct^mairtech .com 
Dnlinc@maetcc h com 
accoiinting@niactec'h.oDm 
11 K irkeiii ig@i ruic let h n 

lnfo@mactcch .com 
http://u'ww.mactcch. a>tn 


'fbe MacTeeb F,diioriiii 

Publisher • Ndl llcktin 

Editor * Nick IX-Nclltj 

Managing Editor • Jessica Stubhicllield 

Online E^lor * Jeff elites 

Web Eilitor • Kevin Avila 


RifguUtr Columnists 
Getting Started 
liy Dan Uarks Sydow 
Programmer's Challenge 
liy Boh Boonsua 
MacTech Oiihiie 
iiy fell elites 

EToni the Factory Floor 
by Richard Aiwdl, Mcirowcrk.s 
Tips & Tidbits 
by Jeff elites 

Regular Contributors 
Vicki Blown, John. C. Daiib, 

Maul F. Sevinc, Kas lliomus. 
and l-j-icik Tejkow.ski 

MacTeeb's Board of Advisors 

Dave Mark, Jtjrdaji Dea-Mattson. 
Jim Straus, Jon Wictlerspan, 
and Eric Giindmm 


Tills puiilicailon is 
prinitfd t>n patter with 
recyclt'd coriieiiL 


Mac'fecb’s ContribuHng tdilors 

• Jim Black, Apple Computer. Inc. 

• Michael Brian lientley 

• Tamck ('clik, Microsoft Ck)rponili<Hi 

• Marshal! Clow, Adobe 

• Hill Doerrfeid. Blucworid 

• Andrew S. Do was 

• Richard V. Ford, Packeieer 

• Coixlon Garli. Qilxili Networks 

• John llanay, Apple Compuici 

• Lure'll Hanns, San Francisco Stale University 

• llenc Mloffnian 

• Chiis KillxjuriT Digital Fore.st 

• Scou KrxtsLer, Mten)sofi 

• Mark Kriegsman, Cleaivvay lech nologics 

• Meter N. Lewis, .Stairways Softvs are 

• Bill McCiasson, Af^[>le Cottipuicr 

• Rich Morin. JVimcTime Mivewarc, Inc. 

• Terje Norderhaug, Media*Design-ln-Progress 

• Nathan Nunn, JTiriiy Soli ware 

• John OTallor\. Maxum DevekjpJiienT 

• Alan Opjxmheiiuer Open IDot^r Nerwurks 

• Avi ita[)pt)iKjrt, Search Totjls Consulting 

• Ty Shipimin, Kagi 

• (Jiiick Sh<iiron, BlAP Systems 

• Cal Simone, Main liveni Soil ware 

• Steve Sisak, Code well Corporation 

• Don Smith 

• Michael Swan, Nam Software 

• ("luick Von Ros|iach, Plaidwa^rks 

• Bill von Hagen 

• John C. Welch 

• Eric Zelenka, StarNine 


Xplafn Cgrfdrai ion 

Chief Fxeoitive Officer * Neil Ticktin 
Presidcfil ■ Anda'a J, Snitlerman 
ControUcr • MidiacI l-ricdrnan 
PriHiuction Manager • Je.ssica Stubhiefteld 
Production * rerrdl Dunn 
Marketing Manager • Nick DeMcllo 
Events Manager * Susan M. Worley 
Netwtrrk AdnitriLstrator • Steve Ruge 
Accouiiliiig * fan Wel)her, Marcte Moriarty 
Customer Relatiojis • Laura Uine 

Susan Ponirantz 

Sliipping/Receiving • Joel Licardie 

Board of Advisors • Sicvcn Gellcr, Blake Park, 
and Abn Car.snid 


All tTonienfs iire Cnpyriglri ]9S^"2(MK) hy Xplain CkMixjfatiun. 
All riglns a'seivtxL MsicTcch, IX^do^xi IXpcJt. ;jnd Spn^ket 
me TrgisicrL'il iradfiittrlcs tT Xpbin Cjtjrpatilkin. iX-jxit, "IIk* 
DLpiJt. Dcjxit SUim. VidfO l>ept>C Macl)ev-I, THINK 
Reference. NetPnafd.sk)n;il. NetMnjl.lve. JavaTech, WefjTech, 
fkTecI), lisplaialt, :iikI the iVLiCriii^irMim sire tmderixtrks nf 
Xplain Corporarinn. Oilier tmtlemarks and ctJpyrigliir. 

in iIiIm |>riiiLliig ui .stjlrwiiie^ lenimn the pro|X'ny cvF 
ihdr rt‘S|xxiivc lioltkrrs. Xpkiln rjnqmrtrifin tkies nol :isw:ime 
any liaNliiy lor eirt^ts tjr rmtivsioivi hy any of the advi.»iiisers, 
ill advenising cronurni, i?dJrc)ri:jl, or oihcr eoniem fmind 
iicreiit. Upiinims or expression.^ stated herein are not 
iKictTvxarily ihcise of the piihlislier and therefore, puhlisher 
assutiles m liai)rlity in regmds tu s;iid siitienieriL'i. 


MacTech Magazine (ISSN- / HSPS: 0 hF 227 ) is jiubiished monthly hy Xplain Corporation, H 5 (bP Hampshire Road, Westlake Village^ GA 

!)l 3 <il- 2800 . Voice: 8 t) 3 / 49 H- 9797 , FAX: 805 / 494 - 9798 , Ooniestic subscription rates arc %i 7 p 0 pcT year. Cahadian subscriptitms ait $ 39 , 0 l> per year All 
pdicr internatipigil subkTiptioiis aie $ 97,00 per ydiiv Dphieistic sph(t:e Irpde disk subscripijrirTLS are $77 per year. All international disk subscriptions ate 
$ 97.00 a yeaXv Please remit in ILlij funds only. Penodicaj postage is paid at Tliousiind Oaks, CA and at additional mailing tkficc. 

POSTMASTER: Send address changes to MacTcch Sifegaaeiiie, P 0 / Box 3200 ^ Westlake Village. CA 91359 - 3260 . . 


2 


Thh S'iakk 


MAt.TECii • Fhbkuaky 2000 





























February 2000 • Volume 16, issue 02 





s 

B 

T 

General | 


■ 

(El 

Logglnv 1 

A \ 


i 

1 


Printing 

1 

\ i 

"M 

Hptiftcfltign 

s 

ji 



■ ■ 1 

SW rfcter 

•f' 


% 

i 


AppleTalk 


i'™' 


^l«ct|«a Tcnputc—- 

r^bfo p- a (am p I sIa doc urnant h&rei 


□ Save database Q Ejcport results 
<Drop a l^idar ftr the resulte lnere> 

RMK Hp^leSc r i - 


Ser&tt^ ^ i 


(jSe^i i [ 


t^ra{i«n AppleScript to run !wre> 


[ Select- 


^ ! r- 3 cllHuiiiip- 

□ fpahla aoftvere mater schsdul rng 


Days 


12 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

ti 

m : ■ f 

12 

E 

2 

3 

4 

5 

6 

7 

8 

^ : 

10 

T1 

Phi ; ; ; 


Default 




I Cancel ] 


netOctopus 3.5...... ____ page 85 


PRCKSRAMMlIiG 

13 Networking with REALbasic 

by Erick J. Tcjkomki 

72 MacLarry 

by E C. Kuecbmann 

SYSTEMS 

54 The Slate of the World in Cryptography 

Jonathan D. (Mias 

EMERGIhlC TECHNOLOGIES 

66 ^Scalable Vector Graphic's 

An Introduction for Programmers 

by Kas l h<ma.s 

NETWORK MANAGEMENT 

85 netOetopus 3-5 

by John C. Welch 

PROGRAMMER'S BOOKSHELF 

90 UML Distilled 

by Paul E. Semn^- 


Feature Articles 

QUICKTIME TOOLKIT 

20 Movie Controller Ptitpourri 

by Tim Memtoe 

TOOLS OF THE TRADE 

44 FileMaker Pro 5 

by William Parier 



upon tms Unit 
Saue Rs Source... 

Saue Rs QiiicIcTime Movie. 
PJitg-fn Settings... 


Movie Controller Potpourri 


.page 20 


Columns 

VIEWPOINT 

4 Macworld SF 2000 Show Report 

b^fjordaft Dea-Maiison and John C\ WeJeh 

GETTING STARTED 

6 Speech Channels 

by Dan Parks Sydow 


Monthly Features 

92 Mac Tech Online hy Jeff elites 
96 Advertiser & Product Index 


FROM THE FACTORY FLOOR 

58 Carbon and PowerPlaiit 

by Greg Do w 

PROGRAMMER'S CHALLENGE 

62 Lathi Squares 

by Bob Boomira 


February 20(¥) • MaCLkch 


Table of Contents 


3 































































































VIEWPOINT 


By Jordan Dca-Mattson and John C. Welch 


Macworld SF 2000 Show Report 


Once a yean tens of thousands of 
Maeintosb enibmiasts descend on San 
francisco to hear Steve Job*s state-of- 
tbe-Mac address, to see the latest 
technologies in action, and play wUh 
the wonderftil new solutions provided 
by third party supporters of the 
Macintosh platform. This year was no 
exception, as show management 
announced over 85f000 enthusiasts 
attended MACWORU) Expo 2000 and 
hundreds of great new products and 
technologies were there to meet them. 

To give our readers the most 
complete show report, MacTecb has 
asked tivo reporters to provide us with 
shoiv retHews based on their individual 
and very different experiences and 
perspectives. The first show report is b)f 
Jordan Dea-Mattson, a former Apple 
insider and long time supporter of 
Macintosh devetopment The second is 
by John C. Welch, an experienced system 
administrator and IS professional Their 
combined report presents a summar}^ of 
MACWORtJ) Expo for those of us behind 
the box, a view of MACWORLD Expo 
from the perspectives of developers and 
system administrators. 


WllAl A DiFl liRIilNCI- A YiLAR MaKES 

A year ago, I was the consuniiiiate insider, hilly 
plugged into what Apple and many developei-s were doing 
at Mat World due to riiy fxjsition as a Technology and 
Relationship Manager (Evangelist for all of yt>u old timers) 
in Apple Worldwide Developer lUtlaticjns. 

Its a year later, and I arii nt)w ‘"just another 
developer" and tiiember tlie press, reading die news 
and rumor sites f>n the web and waiting anxiously for 
Mac World San Pnincistro to roll around, so that I can catch 
tlic latest and greatest. 

And I wasn't the only one with a different perspeciive 
tliis year, f>espite the successful launch of the iMac; a year 
ago, many inemljcrs of the jiress still felt lliat ''beleaguered" 
atid "Afiple” lielonged together like “hani" and ''eggs". A 
yerir later, only the most fringe analysts and pundits are 
painting a picture of an Ap[)lc that will be gcjing away any 
lime in the near future. 

In addition to die arhilysts, press, and pundits, many in 
ihe develop! 1 'coinrTiuniLy liad a difference in |)ei7i|x,'Ciive this 
yc'ar. While tliere is still some jListifiable level of skepticism 
alxxu Apple’s ability' to stick to a strategy and deliver the 
gocKls over the long nm, no one was seen fleeing for the 
exits as many weie* in recent years. 

The Fun is BAt:Kl 

Tliis MacWurkl was the most fun of any in a long time. 
It wasn't that the show itself w'as overwhelmingly fun — 
though it had its niorneiiLs, but raificr that it poirued to a 
fLiturc for A[>|>le and the Mac that was fun. 

Just Icxjking at the user interlace for Mac <")S X or 
playing wiih the new apple.t'oni w'eb site —- more on these 
two later — deiTK^nstrates the renewed sense of playfulness 
and whiii\sy that has Ixren missing for far tfx.) long. 

Conlinued on page 36 


Jordan IK'^-Mattson is an engineering manager ftir Dt>! umenl ik Prim Oevelnper Tet hnulogies at Adohe Systems. Prior 
to being hired into this role, he spent d(?se to 13 years working at Apple in various developer related posiiions, 
inckiding being responsible lor nurturing and managing the Apple-Meirowerks relationship from 1992 to early 1999. 
Jordan can be reached ai jordandm@dea-maiUson.coni. 
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The key to 
thinking different... 



MacHASP USB Keyl 


Question: Is MacHASP USB* a 
software security key or a 
sales tool? 

Answer: It's both! 

MacHASP USB Is the world's first 
software protection key for the 
IMac. It gives you sophisticated 
license enforcement and compre¬ 
hensive protection against illegal 
use... in other words, real security. 

Then ft gives you a big selling 
advantage. 

With MacHASP USB, you can 
license multiple software modules 
and applications. You can instantly 
unlock or upgrade them in the 
field. Pius you can freely distribute 
demos. 

Bottom line: MacHASP USB locks 
out illegal users and unlocks your 


full sales potential - without 
getting in anyone's way. Call now 
to request a Developer’s Kit and 
our newly published guide to USB 
features and benefits. 

*Foralt USB-equipped Macs running an OS 
with USB support. Fully compatible with the 
ADB version of MacHASP. 

ft'»WfMscttiDnsh 

Mac OS 

USA: 1-800-223-4277 
212-564-5678 
Int’l: 972-3-6362222 

www.aks. com/mt 

ALADDIN 

KNOWLEDGE SYSTEMS LTD 


Mac software protection provider, Micro Macro Tecltnologies, becomes part 
of Aladdin, giving its customers even better service from the number one name. 


CETTIlUG 

STARTED 


By Dan Parks Sydow 


Speech Channels 


Getting a speech-capable 
program ready for the use 
of different voices 


In lasl months Getting Siaftetl article 
we started in on the topic of spetx'h in 
Macintosh prognmis. lliere you saw liow 
your ]^rt>gram t'an verify that the user’s Mac 
is able to output sficedi, anti yoii saw hf)vv 
your program can use tlic Speak8lring() 
function to speak the text of one suing, 
rhul was a gcxnj start, but if your program 
is to make gtxxJ use of sjxjetli thei-e are a 
couple of Ollier s|X"ccl>relate€l issues to 
cover. You'll want your program to have 
the ability to s|xak more than a single 
string (without having to refxaiedly call 
S|X'iikSiringO), ITiis month we see how that 
can lx done. You'll also w':mt to give your 
program tlie power to sjxak in dilTerent 
voices. In kusr month’s c(xle we relied on 
the default voice — whatever voice is 
ctitrently set for use on the user’s maciiine. 
But the user has a vvealtli of different voices 
stcjred on iiis i>r lier Mac “ and your 
program can make use of any one of them! 
This month well see liow to make use of 
speech channels. An application-allocated 
speech channel is a preretjuistie for 
speaking in a difiierent voice — so aniied 
with this new speech channel information 
you 11 lx ready fc^r next monthGetting 
Started article where we wnij) u[) tile topic 
of sfxedi by creating an application that 
speaks in different vt>lc:es. 

Speech Basics Re\iew 

It's tile Speech Manager — along with a 
speech synthesizer (that’s a piirt of the Mac 


.system software), the Sound Manager, and a Mac's audio liardw'are 
— that makes s|xech |x>s.sible. If a Mat: pnigram is to speak, it 
should inclutle the Speech,h universal header file to ensure that the 
compiler ic-cognizc's the speech-related l^oolbox fti notions. 

IIinclude <Speech,h> 


Ikltirc^ attempting to speak, your program should verify lliat 
die user's macliine will lx able to ouipin the .sound (refer to last 
montli’s article if you need an explanation of Uie following snippet). 

OSErr err: 
lung responfse: 
long mask: 

err “ Geataltt gcsialtSpeectWtttr, ^response ): 
if ( <?rr 1** noKrr ) 

aoErtort "*\pKrror calling Geetalt"' ): 

mask = I << gestaltSpeechHgrPresent: 

If ( response 4 mask 0 ) 

DoErrert ■*\pSpeech ffniiftger not present " ): 


To Speak a single siring of text, use ihe SpeakStringO function. 
Pass liii,s function a Pa.scal-formatted string and SpeakStringO turns 
the chamcrers ihiit make up the string into speech that emits from 
ihe user’s Mac. f ollow a call to SpeakStringO w'di repeated culls to 
SpeechBusyO to ensua" that time is provided for the full text of the 
-String to lx sjx>ken. 

OSErr err; 

err - SpeakSiriiigt “Vplliis is a test." ): 

If ( err iiuErr ) 

UoEfrorf ■■\pErrQr attempting to spoak a phrafie*’ ); 
while ( SpeschBysyO ^ true ) 


SPEEai CllANMELS 

Whenever a Mac prognim spfsiks, a S|xech channel is 
involved. A spexxh channel Ls a data structure that holds 
descriptive Lnlbrniation about S|xeeli tliat is to “pass through” 
tluii specific channel. The most important property Uiat the 
channel keeps track of is the voice to use. If you want your 
program to speak in two diffiTcnt voices (perhaps a conversation 
Ixtween iwo people Ls going on), liien you'd create two speech 
channels — each channel specifying a different voice. Each time 
your program speak.s, you'd designate which channel is used, 
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Quickly Build and Deploy 
Powerful Data-Driven 
Wieb Applications 
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Lasso Studio and Lasso Web 
Data Engine. Lead The Way. 

Building custom and shrink-wrapped database-driven Web applications requires a whole new way 
of doing things. Having pioneered the Web Data Engine"" over three years ago, Blue World and 
the Lasso Web Data Engine consistently lead the way providing a feature set Web developers 
describe as 'Incredible." Build online stores, discussion forums, resource management systems and 
other demanding database-driven Web applications with unrivaled performance, ease, security, 
extensibility, control and flexibility. Develop using multiple languages— including LDML, CDML, 
Server-Side JavaScript, Java and XML— and deploy across multiple platforms. Your Lasso code 
works identically regardless to which database you're connected. Lasso solutions for FileMaker® Pro 
databases easily scale to big iron ODBC-compliant databases like Oracle, Informix, Sybase and 
more with little or no change. Whafs more, the Lasso Java Application Programming Interface 
(UAPI) provides developers an easy-to-use Java-based API for unprecedented extensibility. 

Find out why hundreds of thousands of websites rely on award-winning Lasso technology for their 
business critical Web data. Download a 30-day evaluation copy at www;blueworld.com/download/ 
or order securely online today at the Blue World Store at store, blue wo rid.com. 

Lasso Product Line - The leading Web tools for Macintosh and beyond. 
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busing ihu t.Itrcision on wiiicli vtiice is uppropriaiu Tor tilt" words 
ttial arc aixnit to be s]^>ken. 

Last month yon learned about SpeakString() — the easy- 
to-use 'rooll^:>x function that s[>caks the text comprising a 
single string. In last month's article we tlidrft need to cover 
speech cliannels because when a call is made to 
SpeakStringO, the Speech Manager takes (-are of the allocation 
of a speech channeh Hie Speech Manager than uses that 
cliannel to speak, anil disposes of that same channel when 
speaking has completed. Because the Speech Manager takes 
t are of all this behind the scenes. SpeakStringO is very' simple 
to use. 'I'here’s a drawback to using SpeakStringO though — 
the programmer lacks control of the speech channel. Because 
of this, a specific voice can’t be selected Instead, 
SpeakStringO ulw'ays u.ses tlie system default voice. Here 
yon 11 see how to create a new- speet'h channel anti then use 
a different Toollxtx function — SpeakTextO — to specify that 
this new' cliannel be used when your program s(>eaks. 

Use the Toolbox function NewSpeechChannel() to create a 
new speecii channel, 'lliis rouli[ie all<jcate.s meiiKiry' for a 
SpeechChannelRecord- 'Ibis is the data staiciure that holds 
information alxjui a speech chan neb NewSpeechChannelO 
finislies by returning to your program a SpeechChannel — a 
pointer to tlie new' sjx'eib channel recortl. 

SpcoctiCluimiel channel: 

OSKrr err: 

err * NewSpeechCh^rmol ( ntl. Ji 

The fir.'it NewSpeechChannelO argumeni is a iMniucr to u 
Vfvice S[>ecirtcation daUi structuiv. As you’ll see in ni'Xi month’s 
(rcfiiuj^ Skiri(*(J ailicle, this data structutv cones[lontls lo the 
voice that is U) k- iiscxi f£>r speech geneniicxJ through this one 
spetvh channel I'o simply use ihe .system defauli vokv. pass nil 
as the first argumeni (as shown here). 

The seconcl arguintnit is the address of a SpeechChannel — 
a data structure that ht>Ids the information about a speech 
channel. After NewSpeechChannelO aIkKaies the sfxvch channel 
recoal tliis variable refi-rences the new record 

Hie 1'oolk)x should have ritt jirobk-m allocating a new 
.speech channel but you’ll want to prepare for the worst. If 
NewSpeechChannelO aiurns an OSErr value tfiber than noErr, 
you can use some standard trrror c'akiiing routine like our own 
DoErrorO, or you can opt to call the rot)!box funaion 
DisposeSpeechChannel() to dispose* of the problematic channel 
yourself. You might also want to set the SpeechChannel vanable 
to nil to indicate to your firogram ihal the variable dries n't hold 
a valid rt*ference to a spc*ech channel. 

]f { rrr 1= noKrr ) 

I 

err ^ DisposeSpeechChannf!] ( fhann^il 1: 

channel ^ nil: 

] 


Your primaiy use* t>f a sfieech channel will be in i:alls to the 
TtK)lk)x function SpeakText(). Unlike SpeakStringO, which accepts 
just a .string of text to speak, SpeakTextO accepts a sfieecli channel 
Lind a buffer of text lo .sjx^ak. Here’s a typica] call to SpeakTextO: 

OSErr err; 

Str255 str “ "VpHere'n a test of SpeakText,": 

err ^ S[H?akT<.'xit fhamtel, (Ptr) Sstr + 1), ^trlOl ); 
if ( err noErr } 

DgEtror( “\pError actemptina to <;pftak a phrase" ); 
while ( SpeechBu^yO ” ttan ) 

The first SpeakTextO argument is a speech channel. Here 
we aren't making good use t>f the speech cbannel — but next 
inonlh, we wall. 

The sec<ind argumt*nt is n pointer to the aiva of memory 
that holds the text to sjxrak. fn the above example I’ve used a 
string to represent the text. Your program could also appemd 
strings logelher in a liuffer, or read text frojii an exteinal file to 
a buffer A varialile of lyfK* StT255 uses its first byte to hold the 
length (in bytes) of the string, and the remaining bytes U) hold 
itie tbaracters rliar make up the string. If we just used str as tlie 
.sc'cond argumenu SpeakTeKt() would atteiiipi to start speaking 
using the value in tlie first byte of str — which happens to be a 
numlH*n By using str + t. w'e tell SpeakTextO to move to die 
second byte of str :md sum speaking from there. I'inally, I>ecause 
SpeakTextO requires a generic poinicr lo a buffer, the Slr255 
varialile needs to Ik- typecast to type Rr. Coileclively (Ptr)(str + 
1) make Uf) the sc^cond argumeni, 

I’fie thial SpeakTextO argument is the numlxT of bytes that 
should Ixf used from the bulTer. In die ciise of a Str265 variable, 
I he numlier of bytes making up tlie string is lieki in the first byte 
of ihe varial)le. So ilic firsi element (hyie |0|) in the S!r255 
variable represents tlie number of bulTcr liyies liokltng 
t'JiLiraclers to Spy'Ll k. 

As you did for SpeakStringO, ^'kh repeated calls to 
SpeechBusyO to provide am])le ume for tlie Mac to speak the 
words in the SpeakTextO butler 

SPlilLtHCHAN 

This month’s program is SjxvchChan, This simjile, non- 
men u-driven progmm provides :i working example ol' how' to 
create and make use of a sound channel When run, SpeediChan 
speaks tlie phrase “WeVe .suecessfully ojiened a speech 
chamicH. After spt'Liking those words the program quits. 

CRFATlJNCi Tllli SHilKaiCllAN RF.St>tTRc:ES 

Sum by crejiiing a nc*w [older riLinied SpeechChan in your 
CxxleWanior development folder. Launtii HesHdil anil create a new 
resource file named SpeechChan.rsre. Specify I hat the SpeechChan 
fokler serv'e a.s die resource files destination. Tliis resiuiae file will 
hold only two re*sount*s. As show-n in Figure 1, ycjiill need just an 
ALRT and a DfTL ivsouav for this pn)jccu 
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You are here 

(parking lot 
water cooler 
conference room 
huddle room 
boss' office 
big boss' office 
latte bar) 

on your laptop, 
on your 
wireless LAN 


WaveLAN* Wireless Solutions from Lucent free 
everyone in your company from the deskbound, 
officebound network. 

With WaveLAN/IEEE Turbo 11Mb Cards, people 
can stay connected, and work productively at the 
speed of Ethernet anywhere they meet, greet or 
get inspired. Standards-based WaveLAN makes 
wireless LANs truly efficient, fast and affordable. 

See how you can boost your productivity at 
1-800-WAVELAN or www.wavelan.com. 


We make the things that 
make communications work.'" 





















The resoiirre file will hold one alert resource — ALRT 128. 
CJorresjX)nding to this ALRT is DITL 128. Together these two 
resources define the )>rogrdnrs error-handling alert. If your 
version of the SpeechChnn progmni dcx'sn'l cuninut any serioas 
errors, then tlic f^rognim won't make use of these resources. 

Creating the Spei-cuCilan Prciject 
Create a new [iroject by starling up CtKieWarrior anti 
eluK)sing New Project from the File menu* Use the 
MacOS:C_C++:MacOS Toolbox:MacOS Toolbox Multi-Target project 
stationary for the new projeii. Uncheck the Casite Folder check 
box before clicking I he OK button. Name the project 
SpeechChan.mcp, and specify that the projects destination be 
lIic existing SpeechChan folder. 

Now add ilie SpeechChan.rsrc resource file to the f>roject. 
ttemtjve ilie SillyBalls.fsrc file. Hie ANSI Libraries folder can .stay 
or go — as is the atse for most of our example projtxis, we 
aren't nuking use* of any ANSI C libraries, so you can remove 
them from the project if you wLsIl 

If you plan on making a PowerPC versiem (or fat version) of 
the S|x.'ecliC]han program, Ix! sum ro add the SpeechLtb library to 
tlie Powerl^C targets of your project. As jiientioned last month, 
yoifll want to cluxise Add Files fiom tlie Project menu and work 
your way over to this libraiy. You 11 find it in the Metrowerks 
CodeWanior:MacOS Support:Ubraries:MacOS Common folder. If you 
c-in't find the library' in tlut folder, use Sherkx'k to searc h your haal 
drive for it* When you add tile library to the [laijeci CxxleWarrior 
displays a dialog lx>x asking you which Lugets to add the libraiy 
to, Check the two PPC taigeLs. In Figure 2 you *see how your 
projcx’t will lfx>k w-ith the SpeechUb library adtled to it. 


O ■“ ^^sSp€ettiCliafi3tn:| 
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Now create a new source code window' by ciloosing New 
liom the File menu.. Save the window, giving it the name 
SpeechChan.c. ChcK>se Add Window frt>ni (he Project menu to add 
new empty tile to the project. Remove the SillyBalls.c 
[ilaceholder file from the project w-indow. At this [x>int you Ye 
ready to type in the source ccxle. 

If you want to save yourself a little typing, cronnecr ro 
the Internet and visit MacTech's ftp site ai 
flp://ftp.niactedi.com/src/. There you 11 find the SpeechChan 
source code file availalile for downloading. 

W.ALKJNc; Through the SoifRCT. Code 
SpeechChan.c starl.s with the inclusion of the Speech.h file. 
!f you compile the sourx^ file and you rcxx'ive a ntimlxfr of 
tindefined function errors, then you most certainly foigot to 
include this universal hoder file. 

includt's 

llnflurtp <Spcedi.h> 

After the ^include comes a single c<mstant. Ttie coastant 
kALRTResJD holds the ID of the ALRT resource used to define 
the error-handling alert. 

/^***************** LOllSUIlUfi 

tfdefin© kALRTSanlO 128 

Next come ilie progntmY function prototyjXfs. 

ftinoiciife 

void TooiBoxInit( void ): 

SpeechChannel OpenOrieSpeechChanneK void ) : 
void DoErrar( ^rrorSi rtng ); 
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REALhasic is the award-winning, visual, object-oriented 
BASIC development environment for the Macintosh. 

Our application is easy enough for beginners and pow¬ 
erful enough tor professionals to use. WhcLlicr you want to 
Icaio (or return!) to programming, REALbasic is for you! 

Simply drag and drop user interface elements into your 
application's windows and dialog boxes to create anything 
from a small utility to a large application or the next great 
game—faster and easier than ever before. Experiment, 

explore, learn, and innovate as 
you build your applications step 
by step while REALlrasic handles 
all the details for you so you 
can concentrate on what makes 
your software great—your ideas! 
With the Professional Edition 
you can even access most 


databases and create applications that run on Windows, 
While REALbasic is easy to use, it's also extremely 
powerful Features like multi-Lhrcadhig, classes, inheri¬ 
tance, a powerful debugger, extensibility, VisualBasic 
project import, advanced dynamic recompiling compiler, 
I'CP/IP controls, and multimedia tools make REALbasic 
the perfect combination of simplicity and sopMstication, 
Go to www.realbasic.com NOW to download 
a FREE trial version or call 512.263,1233 for 
more information, 

8 REALbasic 

REALbasic is a trademark of REAL Software, Inc 

Come see us at MacWorld San Francisco 
— Booth #949 


Best Nciw I'mdiict Most Innov^jtiw 


Best Mjcintoiih 
Usfr rstperk'iitT 
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The main() rimciion of SpeechCh;in starts with the 
cludaralion of several variat)!es. Tlie hrst three variables, err, 
response, and mask, are used in the delerniinatitrn ol' whether 
speech ^*eneration is possii>le on the user's Mac, Tlie other two 
variables, str and channel, are used in the genemrion of speech. 

void omirtt void ) 

( 

OSErr am 
lons^ response: 
lonj^ mask; 

Str255 Btr “*VpWe*"ve Kur.r.p.Rnful 1y opened a spcecti channel."; 
JapaechCIiannol channel. 

After the Toolbox ts initialized the previously diseiissed 
s|x?ech-relaicd tests are made: 

ToolBojcTnitO: 

err ^ Gestalt( gestaitSpeachAttr. £tresponse ): 
if t err i“ noErr ) 

DoError( ’‘\pError calling Gestalt** ): 

mask - 1 << gastaltSpeechMgrPresent; 
if C response h mask = 0 ) 

noError( **\pSpeech Hnnager not present ** )t 

Now we get dow^o to business, first, a speech channel is 
alloealed and a reference to it is saved in local variable t:hannel. 
Note that this local variable could have lx.*en a global varialrle — 
the chcrice is dependent on your progranuuing style, Thu 
ap]:licaiion-dcrined function OpenOneSp 0 echChannel() is 
de.scrilied just ahead. 

channel * OpenOn©SpeechChannel(); 
if C channel “nil ) 

OoKrrort ''\pKrror opening o apeoch channel*' h 

With a valid speech channel* we can make a call to 
SpeakText(). Tlie aigumenls here ntatcli the ones descTilx:d in 
this article's previous SpeakText() example .snippet, 

err = SpeakTestt( channel . (Ptr) tstr -^1), strfOf }: 
if ( err \* noErr ) 

DoEcror{ "\pError attempting to speak a phrase** ): 
while { SpeechBnsyO “ True ) 


Wiien we're finislied speaking, we dispo.se of the speech 
channel. Unlike a call to SpeakSlringQ, SpeakTexlQ re<|Uire(l our 
ei'forts in creating the sfieech channel We made it, st? we need 
to throw* it out. 

err = DisposcSpEechChaimelt channel ); 
if t err !- noErr ) 

DoErrort “\pError dispoeing speech channel" ): 


ToolBoxInitO remains the same as previous versions. 

/...T<xdm>xInJt 

void TaolBoxrr»ii{ void ) 


InitGraft &qd.th©Port ); 

InitFontflO; 

Inlryindowstl: 

Tn it Menus (): 

TEinitO; 

InltDialDgst nil ): 

InitCnrsort); 

OpenOneSpeechChannelO calls NewSpeechChannel() to 
create a new speech channel, the OpenOneSpeechChannelO 
routine is caHed from main(), so that’s where the reference to rhe 
newly created channel gets returned. 

OpenOneSpeechChannel *"*'»***™^^/ 

SpfiechChannel OpenOiidiSpccchChunncl ( void ) 

I 

SpcechGhanncl chunnel; 

OSErr err: 

err - NewSpeechChanneH nil* ^channel ); 

if ( err != noErr ) 

I 

err OlaposcSpeechCliafinoK channel ): 
channel ^ nil: 

I 

return ( channel ); 

I 

DoError(} is unchanged fnaii prior versions. A call to this 
funclkm results in the posltng of an aleri that holds an error 
message. After tlie aleil i,s dismissed I lie program end.s. 

^vnnmPFPVTirpvmvi* 

void DoRrrorE St r?S!> crrorStrlng ) 
i 

FariaaTBxt( errerStting, "Vp". "Vp** ); 

StopAlert( kALRTResID* nil ); 

ExitToShellO: 

I 


Running SpiU’ChCilvn 

Run SpeechChan by chtKising Run from Code Warrior’s 
Project menu. Alter the code is compiled, CodeWarrior Rjns the 
program. Alter the piograin s[>eaks a single phrase, tlie 
program ends. If tlie program successfully builds and appears 
to run and c|uti without .speaking, then I here’s a good chance 
you have the sjieuker v(.)lujue on your Mac set to 01 

Tiij. Nkxt Month..- 

Last month you sttw how your ]>njgram can speak die text in 
a single string. Here you ,saw how* your program am speak a 
greater amouni of text by way of a buffer. You alsr> s;iw how to 
create a s|x,*ech chunneL Next niontli w^eH wrap up the topic i>f 
speech by discTissing liow' you am specify whidi voice — male, 
female, young, old, even rolxilic — you want your program to 
sjK-ak in. Until then you tan study up on speech generation hy 
looking at the Sound volume of ImideMuemUk^h... K1 
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PROGRAMMIMC 


By Brick J. Tejkcni^ki 


Networking with REALbasic 


Make your own network 
game in REALbasic 


Tht^* days it seems everyone is 
jumping on the network iKindwagon. 
From eluii applications to games, from Cl) 
databases to meta-search engines like 
Sherlock, network fimctionaJiiy is an 
important addition to many types of 
software. Luckily, REALbasic aflords us tlie 
aliility to quickly and easily add TCiVfP 
functionality to any application. To 
explore this area of REALbasic 
programming, we will build a simple 
netw'ork version of die evLT-fK)pular game 
Tic-TaC“Tt>c* After building the game, you 
should know enough nl'anu the basic 
principles of sfx:keL applications dial you 
wall lx? able to lx?gin exploring network 
programniing for yourselT 

Background 

Besides an Acklress and Port, your 
applitution should also have a proUxoL A 
protocol is a small ianguage’' that your 
application wall use to commtmicite with 
other computers. Many established 
protocols are already out there for you to 
use (http, SM'rPj ef al), but for this 
example we will construct our own sinit)le 
lie-lac-Ux: protocol. Our protocol will u.se 
three commands: Opponent Moved, 
Opponent Quit, and I Win. Tltesc arc the 
lliree ct)mmands that our application will 
send and receive. To speed things up, we 
will abbreviate the r-ommands in a group 


of lour letters followed by a nuTtilxT in two cases. Listing I 
dciaiis the commands in the protocol. 

Tlte heart of REALbasic 1 CP [>rograniniing is the Stx'ket atntrol 
(see Figure 1). It is through the S(x:kci control wliich your 
application will "talk” to the txjlside world. As such, a SockcH contnM 
has two imjxjrtant properties. 1hey include Address and Port. 



Fi^gifiTc? L 'Ihe Sockei Cornrol. 


Tlic Address property is tite II’ addres.s, which can be found 
in die TC? control pimel or the Remote Access kig if you air using 
iimhp networking. The propt^ny Ls a string and can Ik* set directly 
within the REAUrasic IDE or later by ctxle in your pft>gntm during 
Rintime. The Port property is an integer that fells a scKkcL control 
where to focus its .sending and ret-eiving efforts. A TCP port ls 
siimewhat analogous to a television chiinnd. Just as particular typt?s 
of content appear on ceitam television channels, certain types 


Erick J, Tejkaw'ski is a web developer in for the Zipaloni Comfxmy in SL Umts, MO. In his .S|>are time, he pre^grams shareware 
and frfxTware for his own Purple E Software. You can reach liim at e(t@noreoin2000.eom. 
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inlormaLion apptrar on .specific poit niinilxxs, JSome port nunilxr.s 
are already for use by piT>lotx)ls <'()vering wei>> email, 

chiU, telnet ramniuniaUion, and many [iion:% wliile other pcm 
numbers are Free For you to Lise as you see fit. A nice list oF 
reservect |X)i1 nuiril)crs can lx.' Found in the reFerenee section of 
this article, For example, port 80 is used for hup coriimijnicaLion 
(i.e. web pages), wliile poiT 25 Ls used for Simple Mail Transfer, For 
our example, wc will use pon 815. 

Listing 1. - A Simple I ic-Tac-Toe Protocol 

CoitiiaEiriiJ function Parameters 

oppjq# Opponent Moved Requires an integer indicating 

iocaiion of move 

opqu Opponent Quit Mone 

iwintf I Win Requires an integer IndleaLing location of 
vin 


To build the Tic-Tac-Toc game boaixl, we will use an array 
of BevelButtons, If control arrays are new to you, l>cgin l>y 
adding a BevelButton and changing its Nam© property to 
“gainetiles” and its Index property to xero (J.e. Now, 

whenever you create a BevelButton tliiU shares llie same name, 
REAr.lxLsic: w ill automatically add an Index nujiiber for you. Make 
a grid of nine BevelButtons. 

In addition to the interface controls, tlic w'indow needs a 
Socket control Drag the control onto the w'indow' (location is 
uniinptmnt) and change the Port property to BI5. 

Finally, to spruce tilings up, you c^an ak> add some StaticText 
controls to label parts of your game. For instance, tlie server game 
player will lx; ‘X and the client will be Make a note of that. 
Libel the IP and Port Edifields with StaticText controls. By now', your 
applit'ation should look sometliing like Figure 2. 


How this prole x:ol is ii^xl will Ixx'ome more apixirenl as the 
project ]>rogresses, so jiatient \^ it ckx^sn’l make sense to you yet. 

One final point to ntae alx)ta out projcxrt is that it w^ill really 
1x0 >uill in mo jxms. One game Ixxiid will be the ser\^ev, wliile 
the other will act as the clienL Although this Functionality could 
lie Ixiili mto a single application, it wall help you lo .sec how a 
(lieni diFFei^ from a sc^rver by separating the funLtionality. Despite 
this sc-paration, however, you wilt cjuickly notice that the tw'o 
applications share a lot of the same crxie. Both will respond to 
and send move \"ventsHie dilference lies in the initialization of 
lire game. The server begins liy opening a socket c'ontrol and 
iLtening for a player wishing to jenn the game, Tfie dicni then 
opens a socket and sentis a message to vlie server, asking to join 
the game. Ciame play Ix'gins with both server and client 
re.sixmding similarly to normal game play actions. When ilie game 
is over, liotli the client and server cIo.se their resf)eetive scxkeLs. 

Bluldiisg the Servtr 

First, we will first construct the 1'ic-Tac'-Toe server. Begin by 
starting up RRAlbastc. Version 1 or 2 will work here, though tlie 
source ccxle included on the Mac Tech Ftp site will only work 
with veniion 2,0 or higher. Yoli are [iresenled wllli a default 
project wiih one Window entitled Windowl. Double-click 
WindowT and add Iwo Ediifields, ivvo PtishButions, and a 
StaticText. Name each of the controls as shown in Listing 2. You 
can also change the Caption property of the PushButtons to read 
“Start Game” and “End Game”. 

Listing 2. Window 1 Controls, 



figure 2, 'ihe interface layout. 


Now the time lias come to add some code to tlie server. 
Begin by double-clicking Windowl. tlie menu Edit.,New 

Property and aeaic iwo Btxjlean variables called GameRunning 
and ServersTum. 'Ittese are two flags tliai will lx* usexi lo track 
w'hose turn it is and whether or not there Ls a game in se,ssjon. 
Next, return to Windowl and doul?le-click the SlarlButton. The 
ccxie editor will ojxn in tlie Action event of Lite PushButton. Enter 
the code as shown tn Listing 


Jisting 3, StartHiitton Code, 

Suh ActionO 
//Fin: upMH:kctl 
//to hLjiin listening 
//for Lommands from a clieni 
socket 1 .ad dr ess'll PBox, Lett! 
socket 1 .purL=val [I'ortJkix . text) 
uoeketl.listen 


ConLrul Type 

t'ushJJutton 

PushButton 

Editfieid 

Editfield 

StsticTfixt 


^3ame 

StartButton 
EndButton 
IpEox 
PortBox 
Status 


Next, drag a Line onto the Windowl. Ir can he of any length, 
Ixrcause we will change it in code, hut you might want to 
change its color to .something that .stands out. It will lx; used to 
indicate where a win rxxiirs. Name the Line ""WinLine". 


//scl up ihc gjimc 

Status.te'Xt=“Gaflje started.. .Waiting for a 

EnableAllTiles 

ClearBnard 

win! fne-vlslbie^fala?? 
mt?. yii=iblt?t!“false 
End Hut ton.enabled^!rue 
End Sub 

In tills code, we set up tlie Socket contiol by assigning the 
values From the Fdifields. Since the ixm propeity of a Socket control 
Ls an integer, convert tlie PortBox text to a numixr by using the val{) 
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niuliiocl. Next, die Socket Ls lokl to start listening on the given 
atkia^ss arxi po\X. 'Ilie nest t>f tlie ctxie sets up tlie interface, enabling 
and disabling controls. Notice the wo new merhocls u.sed here. 
EnableAllTiles and CfearBoard will \yc defined later in die article. 

Once tlie Sockei lias begun listening, nothing will bap|X*n 
until j[ receives some data, presumably from a client. Once a 
ecinnecEion is made the Connected event of the Socket fires. In 
tlie code editoi, go to die Connected event of the Socket control 
and add the code from Listing 4. 

Listing 4. The Connected event of the Socket control. 

Snb Conn^cTftriO 

//A I'lieiit has nt:£jiiesk‘d t(i ptay 
//it gjtnrc with this server 
/Aset up giiinc play 
St atus, text=’' flayer j oi ned ” 

GameHunn in ru e 
ServersTurn-^true 
End SubO 

Now that the xScx'ket has leceived a connection from a client, it 
sirs and waits for data. To resiK>nd to incoming daui In>m die cliem, 
entej the code in listing 5 into the Data Available event of Socket 1. 

Listing 5. DataAvailable Event 

\St)b rjfltsAva11 able() 
d I ill s as St r I ng 
dim Cffid tis tjitirig 
dim 1 as integer 

//rcud wliai mm stni lo Uit' servLT S iiockcil 

s=ine.readall 

n[Dd=le.ft (s. 4) 


Select Case emd 
case ""opptT)'’ 

//Jlic £)p|xjncnt hits ititivcd. 

//First find tmtwhich tilt. 
i=val(mid(R,5*!)] 

//then, ntike sure the rile bhnk 
if gametiieti) ,captiGn=”then 
//thcciicm has‘'£/ 

//server Inus^'x" 

ganietiie(i) .caption“"‘0“ 
gametile(i).enafaled=false 
Si* r vfi rflTi 3 1 r ii p. 

status, toxt^"Your tiirn" 

CheekForAWin 
end if 
case ""opiiu" 

Z/Llie opponent quit the pine 
Eie. close 

Status,taxt-^Game Over *" 

Ga m rRu nning=fa1s e 
nisablcAllTnes 
ense "IwirC 
/Ahe oppineiit h:is won 
me .close 

startbutton,enabled^true 
€ndbutton,enabIed“false 

Status.text=''Yon Lose.'" + chr(13) + “Game Over" 

GHtnjeRKnn I ng^f a 1 ne 
nisableAnTlles 
Ser versTurii'^iruo 
i=val[mid(s.b > t)] 

WeLase(i) 

End Select 

End SiibO 

This code is tvhere Sockell re.sponds to incoming diita. 
What type of data, you might ask? I fere is where tlie protocol 
we discussed earlier conies into play. We will respond to die 
commands in Listing 1. First, we read all of the data in the 



" Think about it 

Why should yW 
have to buy a 
USB hub, then hang 
stuff off of it unttUt 
iooks like something out 
of Edward Scissorhandsl 
Why.fumbie around 
under your desk every 
time you want to plug in 
another device? 
instead, try this: A modolat 
stacking system of 
USB hubs, vvith adapters 
for serial and SCSI 
Neat Compact And, oh yeah,,, 
drop dead gorgeous. 
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Mx ket's Imffct Next, we out the first fi>iir ('hiimeters nntl 
do somelliing ha-sed on wliitb eommand wa.s sent. Agiiin» if yt)u 
notice Methocis listed here that are unfamiliar, that is because we 
have not made them yet. 

So far, wc liavc only dealt willi rccx!iving data fiom a client. 

I low do we send data to the diem? Doubte-clkk on one of die 
gametiles. The beauty of having a conool array Is that we only have 
to add ctxlc <jnc Lime. Tlie same axle can apply to all t>f the 
lievelButtons. VMe distinguish which button Ls lieing preased by 
examining the buiton’s imlex pmiierty. listing 6 sliows the code 
dial should l>e entered into Lite gametile. Some game variables are 
changed and the interface is updated, but the most impoitant tiling 
to notice is rt^garding the Socket. First, a string is coastructed that 
includes the "^oppm" command. 'Fhen, the soc:ket semis the string to 
die client by using die Write mediod of Socket!. Tills dan will lx: 
intercepted by the client in much the same way tills server leceived 
data in the l>ata Available event in IJsting 5 

Listing 6. Action Event of ganietiles. 

Sub Action [Index As Integer) 
dim s as string 

If Gai6eRt3nntng“»^i rue then 
i£ ServetsTurn=Lrue then 
me.enabled^taise 
me.caption^"X*' 

//cunsiTiK’i (i mtjvc' Mring tu send lu 
//the client 

f]““op|}in” I fltr [ Index) 

//switch pUyers for next rountl 

Servo I sTiirri=ral se 

status-lexl““Other Flayer^s turn'* 

CheckForAWirs 

//It'i ibc dkiil know aixjul Uic move 
aacketl.wite b 
end If 
end If 
End Sub 

Tlie final contnil neetling ( cxle Is the EndButton [ listing 7). Ihls 
Ixjiion LS included in die event that a user wants to end a game 
prematurely or if the gaim: is a draw. It mercly resets the game 
Ixxiid, variabks, and sends oui a c|uit command to the dienC 

listing 7. ilie EncIButton Action event 

Sub Action(3 
//Sockcl I .t kise 

Status.text*^’'Ganie Over." 

Game Run ning*fa1s e 
DisahleAllTlles 

ServernTurn’-faliJe 
mc,ermbied"£ulse 
StartButton.enabled^true 

socket 1.write “opqu" 

End Sub 

To wrap up this project, we need to add all of the meth(xLs 
that we have been catling in our code. To define a new methtxl, 
select the menu Ed it... New Method. Listing 8 details the code for 
the accessory nielliods. 


listing 8. The methods of Window!. 

Window].ClearBoard: 

Sub GlearBoardC) 
dim i as integer 
for i=0 to 3 
gametilefi) .captioi^*"^ 
next 
End Sub 

Windowl.EnableAllTilesi 
Sub EnabieAllTilesO 
dim i as integer 
for i^O to 8 
garnetileCi).enabled=f nie 
next 
End Sub 

Window1.DisableAllTiles: 

Sub MsabieAilTilesO 
dim 1 as integer 
for i=0 to 8 

gametile[i).enabled^false 
next 
End Sub 

Windovl. CbeckFor AWirt: 

Sub CheckForAWinO 
//check the honztmta] win.s 

if (gametile[0J .captloQ“*'X") and (gametilett) .caption=“X") 
and t garneti1e(2)* ca pt1on=“X") 

WeHaveAWininnr f 1) 
end if 

if Cgametiletl)-caption^^X'') and (garnet 1 le] .caption='’X”) 
and (gametile(5) .caption^^'X") 

WeHaveAWinner(2) 
end if 

if [gametile(6) .caption=''X'*) and (garnetlie(7) .captlQn='‘X'*) 
and (gametile(8) .captlon-'‘X") 

WeHaveAWinnerO) 
end if 

//cheek the vertical wins 

if (gametile[0) .caption-^'X*^) and [gametile(3) .caption’-^-X") 
and f game t i 1 e [ 6). c ap t ion-^'*X ) 

WeHaveAWinner(4) 
end If 

if (garnet ne[ I) .rapt lon'***X''J and [giimtot l]c(4]f .capr Ion-“X") 
and [gaiiieLile( 7) .captiuii-"X") 

WellaveAWinnerlb) 
end if 

if (gainetlle(2) .caption-^^X") and (gainetiletS) .caption^^X") 
and {gaTiietile(83 .caption**X“) 

WeHaveAyinner(6) 
end if 

//check the diagonal wins 

if (garnet ile(0) .raptIon*”‘*X") and {gaiiieLilet4) .capliun='*X'*) 
and (gametile[B) .cup) 

WeltaveAWinnerC/) 
end if 

if (gametile(2) .caption^T) and (garnet ile(43 .caption^''X") 
and (gametile [ 6) .caption^^^X"*) 

WeHaveAW!nner(&3 
end if 
End Sub 

Windowl. Wellave AW inner : 

Sub WedaveAWinnerCv aa integer) 

Select Case w 
//dtdw LMiri^inul win.s 
case 1 

WinLine.xl=14 
WlnLlne.x2=189 
WinLine,yl-90 
WinUrto.y2=9(} 
case 2 

WinLine.xl-14 
yinLine,x2-189 
WinLine.yl^l47 
WlnLine.y2-i47 
cane 3 

WinTJne.xl'^14 

WiiiLine.x2=ia& 

WiiiLine.yl=20S 
WlnLine.yZ=205 
//draw verUcaJ witii 


16 


NtrimiRKiNG wrm REALbasu: 


MAC^KCH • FPltKI ARY 20(X) 






Fast Mac ISAM Access 


case A 

WiiiLiiie*xl=AA 
WinLine*x2^4A 
WiBiine,yl-59 
WiTiLlDe.y2“230 
case S 

WinLtne.xl-104 
WiaLlnc.x?-]OA 
WlriLinc.yM9 
Winline.y2=2iO 
case & 

WiTiLine.xl-:63 
WinLine.x2=163 
Winline,yl"59 
WiniJne.y 2^2.10 
//drpw w\m 

case 7 

WlnLltie.xl“14 
WinLine.x2«19l 
WinLine.y1^59 
WiiiUne.y2“233 
cane 8 

WinLlne.xi“l9l 

Wi rill lie. yi *59 

Witiliiie,y2=233 

End Select 

//display when' Uie win is 

//with a red lirjc 

WinLine. vlElble*^t rue 

//tcli d>c client ih;ri wc wtm 

nocketl .write "iwln'’*str(w) 

//ftstt tbr Kiimf* siatr 

etartbuIign.enabled^t rue 

eadbutton,enttbled^false 

Status.text=“you Win.*' + cbr(l3)+"Giune Over" 
GaneRunning^false 
DisableAllTiles 
ServereTurn“trUG 
Rnrl Suh 

Wincluwl .WeLuae: 

Sub WElqsetw as Ititegef) 

//llic client wen. and this 
//sliows wiicft 
Select Case v 
//htiri/imials 
cane I 

Winli ne.xI'-IA 
WitiLlric.x2*169 
W±tiUne.yl=90 
WinLine.y2”90 
case 2 

yinline.xl-1A 
WlnLine,x2*189 
WinLine,yl-lA7 
WlnLlnp..y2-i47 
case 3 

Wlnlinc.xl-iA 

WluLlue.x2=l89 

WiiiLlne.yl»2C5 

WinLina.y2-205 

//verticals 

case 4 

WinLinfi-xWA 
WI nT.inn. x7-AA 
WlriLiric.yi=59 
WiuLiue.y 2-230 
case 5 

WinLine.xl-lOA 
WiiiLine.xa=104 
WinLlne.yl-59 
WiiiLine,ya-230 
case 6 

WinLine.xl“l63 
Wlullne.x 2=163 
WinLine.yl-by 
WinLine.y2^230 
//dta^ 
case 7 

WlnLine.xl=14 

Vinline.x2-I9t 

WlnLin0,yl-59 

WiuLine.y2-213 
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daea**®®® 

perfo*-*”®"®® 


iMott'**’® 

ISAM 


Real world data uianagejnent 
.solutionK arc typically more complex 
when one examines the pieces, 
lhan initially recognized by the 
majoniy of database progtarnincfs. 
All software projects arc complex 
puzzles comprisol of many details, 
most of which arc data-nelated Often 
today“DBMS"" solutions sacfiftcc 
the speed or control essential for a 
competitive application. 

edree Plus’", by FairC'om. has 
Ijtjen the choice of coTEntercial 
developers for twenty ycarx precisely 
because it offers Ihe flexibilily and 
control at the detail level to fit a 


wide variety of data management 
neetLs. Proven on large Unix servers 
and workstations, e-tree Plus's 
small f(X)tprint and exceptional 
performance have also made it die 
engine iif choice for pnifessional 
developers on Mae and Windows, 
c-irce Plus olTers sophisticated 
ISAM level control with which the 
developer may define precise data 
tnanagement solutions, ntaklng it a 
perfect fit for any development 
project requiring specific data 
handling features. 


C-tZPee Plus^ offers t:he most: 
manure ISAIVI solution today... 


The FairCom 
Server: 

A fir^lid, high performance 
database server that is scaLahle, 
pt>rtable and offers unequalled 
control FaiiCom has been providing 
database solutitms to the commercial 
development community for twenty 
years and supporting Mac tor nearly 
as long. You won't find a better Mac 
DBMS solutlcm. With these features 
and performance anywhere else! 

• Dicnt Side Source Code 

• hrlc Hncrypiion 

• File Mirrortug Logic 

• Full C-onditional Index Support 

• Full Heterogeneous Networking 

• Multiple Communication Protr>cois: 
ADSP; SPX; TCP/I? 

• Online Diiia Backup 

• Small Memory FtxjtpriiU 

• Rcxibic OKM Licensing Options 

• Source Code Avail alrility 

All these platforms 
supported in one package: 

Mac. Mil'S ABl. IJKC Alpha. Sun SPARC. Windows 9X. 

SCO. 880PEN. AIX. RS/6000. HP9000. Sun OS, 

Interactive Unix. Linux (Alpha...). AT&T System V. 

QNX. Free BSD. OS/2, Windows NT. Windows 3.1 , 

JXJS. Netware NLM. & Banyan VINES. 


OonH; wait:, see far yaurself! www-fairconn-cann 

USA. SaO.S 34 .SieO Errail: Infa^faircom.carYi 



□atiabase SOLAJTIPIMS Since 1S79 

Phone: USA 573.445.6833 • 4>a8.035.773.4B4 


JAPAN +81.59.229.7504 * BPAZtL >*455.11.3872.9802 

Othn- comfanjL [rohO: end cprrtnj narim j#a i»ti|>8Ui^tfiigiiaii1^ of respCCtM tumgra. 



FairConn% 
c-tree Plus 
database engine; 

■ Advanced Indexing Technology 

• Cotnpleie Source Code 

• Complete Transaction Processing 

■ ODBC Interface from 
Windows clients 

■ Over 25 Developer's 
Servers Included 

• Ktryalty Free 

• Standalone. Multi-uxcror 
Clieni/Server Models 

• Y2K Compliant 

• Supports Metrowerks. 

Symantec Compilers 












case 8 

WinLiiie.xl-191 
WinLine.*2-i/| 
WtjiIJne»yl'^9 
mnlinQ.yl^m 
End Select 
WiriLlne. visibie=true 
End Sub 

Windovl,Open: 

Sub Open O 

//Somt^ rnltiliKaiinn 
Ga BO R u rtrt 1 ri^= f a 1 se 
EndBu t toil. eiiublud^alEe 
End Sub 


Building the Client 

Once all of the code has been entered, select the menu 
File...Build Application and build a copy of the applk'ation and 
don’t forget to Siive the project. Close REAU>asic and make a 
cx>py of the server pixjjeci and open it. This will lie the basis for 
our client version uf the Tic-iac-ux.^ game. Open the Action event 
for the gametile and replace the code witii that in Ostiiig 9. 

listing 9* The Client ganielile Action Event 

Sub Action(Index As Integer) 
dim B as string 
if GaroeRurining-true then 
if ServersTurn®^taiBe then 
Se rverETurn-trtie 
me * enabled*!alse 
me,caption““0’' 

E^"oppin’* tstr {Index) 

Statun.text“"Othnr Plfiycr*^ Turri“ 

CheckForAWln 
Sunken .write s 
end if 
enii If 
End SubC) 

Another difference in the client version Ls tliat the client tries 
to curmecl to the sender instead of sitting arountl and listening 
like the server does* Listing 10 deuuis the txKle. 

Listing 10 The Client StartButton Action EvenL 

Window!* Sr a rrBut ton.Act ion: 

Sub Act ion 0 

socket 1*addrcss=IPBox*texi 
so eke 11. po iri;=vai (Port Box. text) 

//Connects instead of Jistens!!? 
socketl,connect 
WinLine.visible-false 
iae*enabl€d=false 
EndButton,en?5bletJ’’t rue 
End Sub 

listing 11 shows the DataAvailable event for the client 
MK'ket. You will notice that ilie code is nearly ideniical. Only a 
few clianges have been made tliat are related to the seiver lK.*ing 
X s and the client lx.nng O’s. Hard cocling the players designaEion 
is normally not a gtxKl idea* What if llie client warns to be X? 
However, for this demonstration, we will simplify matters by 
assuming some parameters. 


IJsltng 11. 

Uindowl* Socket 1. DataAvaiiabie : 

Sub DataAvaiiabieO 
diiB s as string 
dim emd as string 
dim i as int&g<^r 
//the commaruls 

//oppm^ -TIie opfuioenT matlc jl move on tile* 

//optpi -The oppuiK^ni has quit the game. 

// 

s-rae,readall 
ciidHeftfs*4) 

Select Case cmd 
case ^oppm“ 

//'Hie opponent hail moved 
//to which tile? 
i=val(mid(a,S.l)) 

//make sure the tile is blank firsi 
if gametiled) .caption’*"" then 
//die elieni has 'o" 

//server lias^x" 

gametile (i) *caption”“X’' 
garnetile[i),enabled~fa 1 se 
ScrversTuro^falsc 
status.iext="Your I'urn'' 

GheckForAWiu 
end i f 
case “opqu* 
me.close 

Status.text=“Gaiip Over." 

Gamekiinni ng=fal3e 
BisablcAliTlles 
case " iwlii" 

//Winlinc visibk^iruc 
//socket 1 .write ‘iwin" 
me.close 

B t a r tb u 11 on. enab 1 ed^t r ue 
endbutton.enab1ed”fa1ne 

Stai us.l okI='"You Lose," + chr(nl+'^Game Over" 

Game Ku tuii tig-f al s e 
DisableAllTlles 
ServersTurn=true 
i^val{!nid(s*S.l)) 

WeLosefi) 

End Select 
End Sub 

The last trhangt* to make to the cmle in%'olve.s the Socket 
Connected evciiL \Yhercus the *servLT s^jckei fires the Connected 
event when the client requests to play a game, the client's 
Connected event will fire after the server accept-s a connection 
from the client. Listiiig 12 shows ilie net essiiry c'hanges. 

Window l^Sockct 1 *C«)nnected; 

Sub Connpc loti (i 
GiUiJt?RunniJig=^t rue 
ServersTurn^true 

status,text^”Game started.** + chr(n) 1 "Othor Players turn" 
EnabieAliTiJes 
ClearBoard 
End Sub 


Testing hie Game 

Having morphed die copy of foe server pix^ject into a client by 
hanging a bit of ttxle, seleti the menu nie*.*Build Application and 
build a client veiskm. To test Uic game, .start up Ixrth ihe server and 
client appliaitioas. Enter yoiir IF addiess into tlie appixiphaie Ixixes 
in tx>i[i appfinttkias. Next, click on the StartButton in foe serv^er 
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window. Mils inilkiltrs ihe game. The ?«erver siLs and waiLs for a client 
to join. Click t>n die client window and press the StartButton. If 
everytliing goes right, you should see confinnation tliat tlie game 
has I'legun and infonmjiiron re^rding wiiidi pbyeis turn it Is. Go 
ahead and play youiselT in Tic-Tac-Toe. Tiy quitting early aixl 
winnuig in liilTerent manners. 

iMPROVIvMliNTS 

You will prolxibiy notice some places where the g^ime could 
be improved. Absolutely! 'ihese applications do not cficck for 
errors, which is always iinfiortarU, but was left out for die sake of 
simplicity. Further, the two applications could 1 k^ easily merged 
into one. fhe user can then decide if he wishes to l>c die server 
or the client. Again^ this wa.s avoided for demonstnition purfxjses. 
Ik’sides, you may sometimes want to have separate server and 
client applic;Uions. In the multimedia realm, the game could 1 k‘ 
improved with fan<‘y graphics and sound as well as a scorelxiard 
and a liosl of olher features. Tliese are all areas for you to explore. 
RFALliasic makes it easy to do so. 

Conclusion 

In thi.s article we Uxiked at a basic .server/cltent Tic-Tac-Toc 
game and intrcxhtced the Stx’ket conlnd. Not all asjx'cls of the 
control were* t:ovLTed. To learn more about the socket control 
you should considt some other references. 

As iLsuiif the web is a g(MKl place to siart exploring moie 
infonnalion alx)ul scx'kct coiimiunication witli l^lLALliasic. Check the 


reference section for a list of sites that have somcdiing iti oflcT. 
Funhemi()a:, Matt Neulxrig's lxx>k RliAihasic: Ihe Definitive Guide 
oflcjs iicvenil excellent socket examples, including entuf w^eb 
servers, and an online dictionary application. Finally, a pevk at die 
dcx*umentation provided l)y REALlxisic will also give you a gtxxl 
ixickgrtJond in REALlxisic sockets. 

The world of netw'ork applications is constantly evolving 
and there are still many opporitmUics for j>ix)grammcTs to make 
new advances in netw'ork ap]:)Iicatians, REALhasic offers the 
lieginner a great way to easily learn about the topic, while 
providing the advanced prograinmcr a ricli set of feulures for 
Lii Hiding Ten’ communication, Nave fun exploring and be sure to 
send me all Battleship''^ games you conc'txid 

RLFIiRlLNOiS 

• REALsoftware/ REAIiasic 
http://www.realsoftvvare.corn 
http://www.realbasic.com 

• Common TCP Ports 

ftp://ftp.isi.edu/inmotes/iana/assignments/port-numbefs 

• REALbasic Monthly 

http://www.nd.edu/'-)vanderk/rbm/9-98/index.html 

• REALbasic: The Definitive Guide, by Matt Neuberg 
http://www.oreillyxom/catalog/reafbasic/ 

• Essence Software 
http://www.essenceswxom/ 


Mac programming is complex. 
The answer is easy. 
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Rapid Development 
in your language. 

Tools Plus Pro quickly 
turns your great ideas 
into great applications 
using C/C++ & Pascal. 

Everything works as 
soon as you create it. 

It's easy to learn, 
really easy to use, and 
a breeze to maintain. 
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QUICKTIME 

TOOLKIT 


By Tim Monroe 


Movie Controller Potpourri 


More Adventures with 
QuickTime's Movie 
Controllers 


iNTROIMKTION 

In tlie pivvtous amclc. wc Icamal him 
to open QLiick l inie movie?^ :mti dispby tliein 
in windows on the sc reen. We also leameii 
how to ovate movie aaiinJlers and pass 
events to tiieni so dial the user can intenict 
with the movies in die mtxst Kasic ways, For 
nonnal linciif QuickTime movies, these 
basic intemetions include starling and 
slopping the movie, moving quickly forward 
or Ixickwaai in the movie, adjusiing tlie 
volume of the sound track, and [K'rfonning 
simple eciiting operations on the nK>vie. I'or 
QuickTime V\{ movk^. the hisic intemctifjns 
include ckinging the |ian and tilt angle's, 
7j(x>ming in or out. moving fiom one ncxle to 
another, and dlspbiying the visible hot sjxit.s, 
All of tills interaction Ls j>n)vided, witli 
vimially no programming on CHir fxirt. by the 
movie conlrtiilcr asscK iaittl wiih rhe movie, 

in this article, we're going to continue 
working with movie njnii-ollers. Now that 
we’ve done all the work neces-sary to 
a,ssociate a movie controller with a movie 
and to draw' liie movie and movie conirtjller 
in a w'indow on the screen, there* is a 
tremendous aiiujunt of “low-hanging fniiT” 
that we c'an pick with a very small amount 
of ctxle. Here we'll see how to hide and 
show' the movie controller l>ar, hide and 
show particular Ixitions in tlie Ixtr. ailacli a 


p<ip~up menu to the recently-introducvd custom button in the 
conitxiiler kir, and pc*rform several other t:isks on the controller kir. 
Toward the end of tJiis article, w-ell also ilm)w in a few g<xxlies 
that are only slightly more complicaicxl. like getting a movie 
cxiniroller to open a URL in the user’s default web browser 

Along tlie way. we’ll shift our hxm sligluly and take a kxik at 
mapie user dam, w^hidi is some custom data that can lx: attached 
to a movie. You c'an use' a movie's user data to specify lots of 
iiifonuation alxiut a movie, including the iniiial position of the 
movie window, the movie's kxjping slate, and llie movies 
copyright information, ibis isni completely unielaled to our main 
topic in this article. !xx:ause movie c'onirollers and movie user data 
are linked in one important w'ay' for a mtwie to use* a special movie 
controller Ukit Ls, any controller other than the standard linear 
movie controllerj, the movies ii.SiT data must include a piece of 
information that .sjx'cifies w Inch other contii>ller to use. When you 
C 41 II NewMovieController to asstxiatc a movie ctjntroller witlr an 
ojx*n movie, Quickilme l(K)ks for that piece of user data and. if it 
luicls it, ojx-ns tlie sfxrilled nuivie txmtnilfer. Here we'll see hoW' 
we tnti can insped that data and use i 1 for our own purposes. 

Ikfore w^e begin, it's worthwhile to emphasize once again 
the distinction Ixiiwren a m< wie coniroiltT ami a movie controller 
bar. A movie controller is a stjftware comixjneni that you can use 
10 manage the user's interaction with a QuickTime movie, A 
movie controller bar is a visible set of controls and other u.ser- 
interfiK'e elements that is disjilayed l)y a movie controller (usually 
along the bottom of the movie wiiick>w-) and that provides some 
ways for the user U? intenict wiili ihe movie. The movie 
controller typically .su[iports some forms of user inlcTaction that 
are nor assodated with the controller bar (for instance, hitting the 
space bar slans or slops a linear QuickTime movie). Moreover, 
it’s possible to have a movie cotiiroller asscxiatetl with a movie 
but no visible movie controller bar (as well see shortly); even 
wlien the movie ccmiroller bar is hidden, the user can still 
interact with the movie. This distinction needs cmpliasiziog only 
Ix^axitse it s not uncommon to hear |x*ople talk about tlie movie 
controller wlien they really mean the movie controller bar. 


11m Mtmroe <manrTx*@apple,com> Ls a ,software engineer on Apples Quicklime lie is cunvnlly developing sanii>le 
code and utilities for the Quickl’ime software developmtmt kii. 
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Managing the Controixer Bar 
Showing and Hiding the Controller Bar 

So let's get started picking some of that low-hanging fruit. 
One of the simplest things we can do is hide the movie 
amirollcr bar, with this single line of code: 

MCSptVifllbletinyMC. fatRC-)i 

(Here niyMC refers to a movie controller.) 'ITie MCSetVisible 
function sets the controller bar to Ik‘ visil)le or invisible, 
according to the Boolean value you pass it. Figure 1 shows a 
movie windem' with the controller bar hidden. 



figure 1: A movie window with a bidden movie amlwHer imr 

Lei's lake a niomeni to deline a couple of functions that call 
MClSetVisible with the Lippi opriaie parameter, mainly to give 
{yiirselves a more uniform naming convention and to make our 
code a bit more rcaclahic. lasting I defines the function 
QTlitiLs_Ilide€onirollerB:ir and Listing 2 defines the opposite 
function, Ql'Utils_ShowControl lerBar 

Listing 1: Hiding tlie controller bar _ 

QTt itiI.s_Hidc( ](iii i tt >1 ItrRiir 

void QTOtils Hidf^CoiitrolIerE^r (Mov i eCotiLioller LheWC) 

f 

MCSetVii3lblfe(LbeMC. false): 


Listing 2: Showin g the controller har ___ 

QTl Itib>_siK>wC:( jni r< iIlcrBiir 

void QTlJrnH_SliovControl 1 erbar iMovieCantrallEr theMG) 

I 

MCSoLVltiible t theMC. true); 

! 


And we can pul this all together to define a function that 
toggles the current visibility state of the controller bar, as shown 
in Listing 4, 

Listing 4: Toggling tlie visibility state of the controller bar 

QTt It jLs _ToKSteQ>nrn>lle rlkr 

void QTUtiisJTog^isCoatrollerBar (MovieController theKG) 
f 

if (QTtltils„ IsControllerBarVisTb1e [theMC)) 

QTtltlls_Hidecontrol 1 erBar(theMC): 

QTU 111 s„Sho wC 0 tit ro i i e r Ba r (t he MC): 

I 

No douLit there are more than a few^ of you out there 
scratching your heads and wondering why we didn’t simply 
define QTLItils_ToggleControllerBar witli this single line of cxxle: 

MCSEtVlsibie! (theMC, I (BoaleBnjMCGetVi sible{tbeMC)); 

We surely could have done that, but personally f find the 
definition in Listing 4 to lie a tad more readable. 

Using Badges 

While we'ie on the topic of hiding and showing the 
controller bar, ifs worth mentioning a useful but little-used user 
interface element known as a badge. Tlie idea beliind badges is 
that a movie window that lias no ct>nirollcr bar Ltnd whtxse movie 
is nor actively playing looks remarkably like a window' contLiining 
a still picture. {Take another look at Figure 1.) To help the user 
realize that the window is aaually a movie window containing a 
stoj^ped movie wath no visible controller bar, the tnovie controller 
c;m be made to display a badge, as seen in Figure 2. 



Figure 2: A movie window disp/aying a badge 


We can call the MCGetVisible furution to determine whether 
the controller bar is currenrly visible, as shown in Listing 


Listing 3: Octermining whether tlie controller bar is 

visible_ 

Q'J’Uiib_ltieonimllerBarVLsible 

Boolean qTUtilH^iiiControIlerBarVisibie (MovieController 
n-iowc) 

I 

return ({Booiean)tlCGetVi6ible(theHC)); 

) 


The movie controller displays the badge w4ienever the movie is 
stopped and theie is no visible movie coniK>ller l)ar, but only if you 

have previously configured the movie controller to do so, tike tiiis: 
MCUoAcliontmyMC. mcActlonSetUseBadge, [void *)true}; 

A useful l^ture of a badge is thai the user exin make the 
controller bar reappear by clicking in tlie badge. If you want, 
you can explicitly disable the movie controller from using a 
badge by executing this line of ccxJe: 

HCDoActlDfi(inyKC. raic Ac tionSetUae Badge, (void *) false): 
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You’ll find thut line in die function Q1Tnime_SctupController in 
our source code Rle ComAppltcntion.c to suppress bnclge display 
for any movies we display. 


Attacliijig and Detaching the Controller Bar 

'llie deRmlr behavior of a movie a>niroller is lo draw tite 
movie control ler kir conLiguous to, iind just iindeniearfi, tlie movie 
tliat it is contixtlling. In virtually all eases, iliis results in exactly the 
apjxntrance for movie windows that irsers expect. JM for .some 
purpexses, tl might lx prefemble to position llie movie contioller Itai' 
e]se‘wlieTe. Qulckl'inie allows us to do tlijs quite easily. Ihe first 
tiling we need to do is detach the movit^ controller from tlie movie 
{a new movie (“ontroller is, by default, aitadied to its movie). We 
am do tills by ailling MCl^k-tCciiUiollcrAtUtched like tills: 

MCSetControUerAttschedlwyMC, false) i 

Tlie next thing we need to do is specify the desUed new' 
Icxaiions of the movie arid movie controller bar. Listing 5 defines 
a function, QYlllil.s_PiitQ>ntrollerRarOnTt)p, that places die 
controller I jar alxjve d ie movie. 


lasting 5: Putting the controller bar above a movie 

Qn Xils_PiitQMitn)Ut:rRart)nTop 

void t3rUtiis_PutControiierBiir0riTop tMavieConiroller theMC) 
t 

if (theHC — NULL) 
return; 

If (KCTfiConTrolterArraehp.tKtheKC) — 1) I 
Rt'c-L myWCToet: 

Rec t njy Mo vie Ret t: 

MCCetCont rol 1 e rUqundsRett (theMC. itmyHCRtc L): 
myHovieRect layMCRectr 
inyMCReet,bottom “ EnyMCKect .top + 

QTUt i 1 fi_GetCo n t ro 11 e r Ba rHei ght { theMC): 

jnyMovieRert.top ” myKCRent.bottom * I; 

MCSetCoiit rollerAtinched {ihcMG, Tfi 1 sn) ; 

HCPositioiiCoiitroIler (thfMC. ^inyMovleRcct, ^myWCReet. OL): 

I 

I 


Figure 3 shawls a sample movie window after ihe 
QTLItilsjnitQimroUerBarOnTop function has Ixen allied on it. 
In this case, the controller bar is still contiguous to the movie, 
but it is no longer attaclied to it. 



figure 3: A controller on top of a moine 


In geneml, as tVe said, it's Ixst to retain die standard 
appearance of movie windows, where the controller Ls 
underneath and attached to the window. Rui it's still sometimes 
useful to detach a movie confroller from iLs jiKjvie, even il just 
firiefly. One example of diLs is if you wanted to tletermine the 
height of the movie controller bar (which, incidenTuIly, we 
needed to do in Listing 5). There is nci programming interlace 
for gciting this infonnation directly. QuickTime does however 
supply tlie riinction MCGetControilerBound.sRect, which returns 
the rectangle that encloses the movie ttmiroller. The only 
"^gotcha” liere is itiaL the movie controller rectangle is defined as 
the ix'clangle tliat encloses llie movie controller l>ar cind the 
movie, if the movie conrroller Is attac'hed to the movie; 
otherwise^ if the movie ctjntrollcr Is detached from the movie, 
the movie controller rectangie encltjses just the movie controller 
bar. !So, to determine die heiglit of the movie coni roller liar, we 
first need to detach the controller bar, if ids currc'iilly attached, 
and then retrieve die movie controller rectangle. Listing 6 shows 
our complete function for doing this. 

LLsling 6: Finding die height of the controller bar 

Q'tl J lib_(krl(A>iitn»Ui:iiSarl Idgjit 

atiofi EJTUt nG_Get:noni-rol li^rBarHeight {MovieCantfoller theHC) 

! 

Boolean wasAttaL'liad = £alt?e; 

Rect tayKect: 
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// if tJi€ cuntmUcr bsir is iiuachcd. lictacli ii (and rcnicmb^^r we did mj) 
if tMCisControllerAttachedEtheMG) ^ 1 ) t 

vasArt ached = true: 

MCSetContriJllerAttacheditJaeMC, false) r 

1 

// J5rt the of die controUrr 

MCGetCoot rollorBoundsRectUheMC. AmyRectJ 3 

// now reattach ihc coot oilier hat if li was origirially atiached 
if (wasAitached) 

MCSetControilerAttachedCtheKC. true)3 

return (tnyRect. hot tarn - tnyRecT.tap); 

I 

Mana(;in(; Controlijh Bar Buttons 

Now that weVe played a little bit with the movie cotiiroller 
bur^ let's consider how' to work with individual liutlons in the 
controller bar. In general tJic only thing we can do with the 
individual buttoas Is hide and show' them We amiiot disable or 
enai)le them, and we cannot directly h;inclle dicks on them. "Hie 
only excepdtKi to this concerns tiie t t>nLn)iler bar's ciisioni button: 
we can intercept and re;ict to clicks on the cusioin button, as we’ll 
see later in “Using the Q>ntroiler Bar Custom Butlori". 

Managing die Standard Controller Buttons 

l’)egin by ct>nsidering tlie standard Quickl'inie movie 
coniroller l)ar. There are only four buttons that QuickTime 
allows us to show or hide: the volume control (someiiines also 
called the speaker buttonX the step-tbrward and step-back ward 
buttons, and llie cuslt>m button. By default, the volume control 
is displayed if and only if the asstKaaied movie conhiias a sound 
or music track. We can hide the vulunic control if we cluK)se, 
bill W'e cannot make it visible if tlie iiKWie dt)es nt>t have a 
sound or music track. All the other butttms are displayed all the 
lime, unles.s we programmatically su]>i>ress tliem. We can 
.siippre.ss the display of sonw of these buttons by manipulating 
tlie movie's cow/ro/ Jhigs, a 32-bit value whose bits enctxle the 
settings of various movie dis[>lay and playback options, 
QuickTime defines iliese coastanis for showing and hiding 
buttons in the standard movie controller bar: 

enum t 

mrFl«£Sy|jprca'jStc‘pRul loiia =1 << K 

iwFla&SuppreusSp^ykerUutton = 1« 2, 

lULFlii^uLTstiCuiStomliutton ^ 1 « 5 

I: 

?^o, for inslanc:e, we ('an hide the two .step buttons by 
executing tills ccxie: 

MCDoActlon{ntyMC. nfiArtionGptFlA^fi, AmyCofit roltirFliigs): 

MCD<tArf if>n(niyMC. mcArr tonSet Flags ♦ (void ') CrayCoiitrolIerFlags 
I BcFlagSuppretjySLepButtoris)): 

Tlic iriea here is simple: we get the current control flags, set 
the bit in ifiose flags lliai suppresses display of the step btiltons, 
and then send the updated Hags Irack to die tiiovie controller 
Naturally, to .show a button that’s Ix’cn hidden we do liie 
opIKJsiie; namely, we get ihe r'urrent control flags, clc^ar the 
apprt>priale bit in those flags, and tlien send ifie updated flags 
back to the movie controller: 


HCDoActionCioyMC, acActionGetFlags, SmyControll(?rFlage): 
HCDoActionfmyKC, mtAct ion Set Flags. [void *) (jiiyCoiilrollerFlags 
& -"wcFlagSupprcssSLepflui Lons)): 

One tiling to watch out for is that tlie senianiics for die custom 
billion are the a^verst' of those for the other buttons: .setting the 
flag fur die custom button results in dial buiion lieing displayed, 
while clearing diiit flag msulls in the button lx‘ing hidden. Tills is 
Iiet'ause the custom bunon Is, by default, not displayed. 

Managing the QuickTime VR Controller Buttons 

Tile QuickTime VR movie controller is more generous tlian 
die standard movie coni roller, in that it allows us to show^ or 
hide any of die contrtds in its controller bar (including the 
volume controi). Hut this generosity comes at the price of a 
slight increase in complexity. The simple clearing and setting of 
bit-s in the control flags shown uIkjvc dot's not always give die 
de.sired result. Ihis is because the QuickTime VR movie 
conirrifler .sometimes .siippre.sses buttons even when those 
buttons have not been exfdicilly suppres^sed in the control dags. 
For example, if a particular QuickTime VK movie does not 
contain a sound (rack, then the movie controller automatically 
suppres.scs the volume conln>l l.ikewisi^ if a QuickTime VR 
movie does contain a sound track, then the volume control is 
auTomatically displayed, again wathoul regard to the actual value 
of die incFlagSupfiressSpitikerHijiUiri hag in the control Bags. 

So far, this behavior is kleruical to that of the standard 
movie controller, 1’he main tiifference Ixtween the tw^o 
controllers is tfiai die Quick'f'ime VK movie controller does 
[irovide a way for us to override its default Ix’liavior. We migiit 
want to do thi.s, for instance, if our application has loaded a 
.sound from a resource or some external file and we'd like to 
allow die user to adjust the volume of that .sound using the 
volume control (Wait a second! Didn't 1 just say that we can't 
intercept moiLse clicks on the ctJiitrnller liar buttons? If so, then 
how are we sufjposed lo respond to the ustar's adjusting the 
volume using die volume control? Hie answer is that we can't 
tlirectly determine lh:il the u.sta' lias clicked on the volume 
control, but we can wait for the movie controller 10 tell u,se that 
the user has changed die vtiUime, by kxiking for movie 
controller actioas of type mcActionSelVolunie. So, indirectly, we 
can accomplish what we want heit'.) 

To let us override its default beliavior, tlie QLiickTime VR 
movie confroller iriainiains two .sets of^ flags, a set of ccnilrcflJktgs 
Uvidi which are already familiar) and a sea of Jkigs. 

The explicit Rags indicate vvhicli bits in the control Hags are to 
lx‘ used explicitly (that is, overriding any default iTehaviors of 
the movie comroller). If a p:iniciilar hit in the explicit flags Is set, 
then die corresix>nding ()il in die control I1ag.s is inierpreted as 
the desired setting tor that fe-ature. Ginversely, if a particular bit 
in the explicit Hags is clear, then the corresjxMiding bit in the 
coritRjl [lags is interpreted as ti normally is. In thi.s way, the 
explicit flags ojx'rate as a sort of mask lor the control bit.s. 
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To m:ike this t lctircr, Id s consider a concTcie exauiple. 11\e 
QuickTime VR movie controller cleline.s these constants for 
workinj^ with its controller bar buttons; 

1 

jiicFlagQTVRSiippreasBackBtTV ^ It « 16. 

BiclTaBQTVFSuppreaaZooinBtns ’ It « 17. 

iiicFia£QTyRSijnprfiaaH0tSpotBtn ^ It << 16. 

mcFiagtJTVHSupprcaaTransiateBtn “ LL « 19. 

mcFla&QTVRSuppteaiiHclpText - XL « 30. 

DicFlagOTVRSuppresallotSpoTNaaefl * IL « 21, 

fSfFlagQTVRExpllcltFlagSel = IL « 31 


If, for example, bit 17 is set in a movie;s explicit Hags and bii 17 
is eleiir in that movie's control Hags, tlien the zcK>ni l>ullt>n>s are 
displayed (that is. iliey are not suppressed). Similarly, if bit 2 is 
set in a movie's ex[ilicit (lags and bit 2 is clear in that movie's 
cxmlrol Hags, then the volume control is displayeii, wficther or 
ntjt the movie coniains a sound track. 

Tliere Ls one final element to ihis whole story. We need a way 
of getting and setting a movie contitrller's explicit Hags. Rat Iter than 
iniicxluce any new movie controller aerton.s, ihe QuickTime VR 
enginet:T>j dceidal to use tlie existing actions (mcActionGetFIags 
and incActionSetMags) but lo have tliose actions openite on tlie 
explicit Hags or the t'oniiol ibgs, clejx^nding upon tlie .setting of bit 
31 (defined as mtTlagQTVRlixplictTFlagSet) in die value passed to 
MC'DoAction. To get or set a bit in a movie’s explidi Hags, you 
must set die Hag incFlagQlVRExplicitFlagSct in die parameter you 
pass to mc:AcaionCietFiags or mcActionSetFlags. To get or set a bit 
in a nujvie's control Hags, you iiiusl dear the Hag 
mcriagQTV'RHxpliciiFlagSei lit the parameter you pass to 
mcAdionGtaFlags or mcActitrnSdUags. 

So let's put this all together and see Itow we can forc'c the 
volume control to be displayed in the controller bar of a 
Quick'rime VR movie diat does not contain a sound track. First, 
we need lo get the movie's explit'ii Hags and set the bit in those 
exfilicit flags that corresponds to llie volume cnfitrr>l: 

rayControllerFlags * acFlagQTVFExpllcitFlagSet: 

HCrkiAftlontinyMC, cncActluriGtUFla&a , AmyControIlerFlagB) * 

HCDuAcl irtntmyMC, mcActianSetfclaaa, (void 
') ((tiyControllerFlfl^E | incFlagSupprcssSp#*flkerButton) | 
HcFlafiQTVRExplId tFlagSetl): 

Note that when you irse die defined constants to set values 
ifi the explicit Hags, the i’onstant names might Ix^ a bit confusing. 
For instance, setting die hit mcFlagSiipprc,s.sSpeakerButton in a 
movie's explicit Hags doesn't cause the speaker to be 
suppressed; it jiisi means: **use the aaual value of the 
mcFlagSuppre.ssSpL-akerButton bit in the cxintrcrl Hags’*. 

Next, we need to set the apfirofjrtate bit in the movie's 
control Hags, like this: 

myControilerFlags “ 0: 

MGDoAotion(ayMC. mcActionGelFl ap* imyCcntrollarFlags) j 
MCOuAcuionfittyMC. mcActionSetFlags, (void *)(ByControllerFlago 
& ^QicFlagSdppr^EsSpeakerButton 6i 
■^■WcFlagqTVRFxpl ic ItFlaRSet)): 

Once weVe exmited iiie.se* six lines of code, the volume 
control will appear in die controller bar, w-heiher cjr not the 


a.ssodated Quick'lime VR movie has a sound track. 

Listing 7 combines die results of our discussions in this 
section anti die previous section into a single, unified funedon 
That we can use to show buttons in a movie conEroller liar. 


Listing 7 : Showing a button m the conlroUer bar _ 

gn I rjU_ Showt :cjiUnJllcrBurHin 

void QTUtllB„Sh 0 wCoiTtrollerButT:oii (MovicCon trailer thehC. 
loot iheBirttaii) 

I 

long rayControllerFlags; 

// handle the custom btiiion scpnraidy 
if (ihnBiitton = mcFiagsUatCusiarnHntton) I 

MCLluAciIsnCtheWC. mcActionCetFlags. imyControilerFlags): 
MCDoActiuiitthcMC. mcActionSetFlags, 

(void *H!ByControllerFlags | tbeBution)): 

1 else f 

// g|Lt Uif curnetii cxjditit flugs and set the cxpMdi flag for the ^fccificd button 
rayControllerFlags = nicFlagQTVRExpilcitFiagSet: 
M(XoAction(theXC, incAclionGetFlags. fiimyControllerlToge): 
HCfJoArt 1 onfthcHC. otcActiDoSeLFiaga. 

(vg]d *)({myControllerFlags | ihcBntton) | 
iiicn^^aQTVKExplicltFlagSet)}: 

// go tk' ewrent control flags and dear tlic sxiiJjinrss Hag for ihc fspeeik’d huilon 
myControllerFlitgc " 0; 

HCDoActioti(theHC. mcAct lanGetFlags, SimyContrullcrFlags); 
MCDoActi on [ theMC. mcAc tiotiSetFl age. 

(void *) (myControIleiFi.ags h -theButton & 
'-mcFlagQTi/FExplicitFlagSeL)); 

I 

1 

'The c'ornesponding function to iiide a button in the movie 
controller bar is exactly parallel; if you're interested, take a look 
at QTUtils_I iideControllcrButton in the file QTUtililics.c. 

Curarndy, only tlie Quick'Ume Vl^ movie cxintrollcr maintains a 
separate sci of explicit tbgs and hence knows how^ to interpret die 
incFkigQTVIlExpliciTFbtgScd flag. This means that die .standaal 
Quicklime movie eoniroller will actiutlly Ix' gelling and setting the 
movies eonirol flags wiien w'e make tlie calls to get and set the 
explicit flags. We ve carehilly written QTlItils_ShowO.>ntrf>llerButton 
and Q'fLJtilsJlideQjnirollerBunon so that no liann is done if a 
movie t'oniroller docs ncx support any explicit flag^. 

Using thf Con i roller B*ar Custom Bu i ton 
In t^iiitkTime 3, movie controllers gained the ability ro 
display and manage a custom controller liar button. As you can 
see in Figure 4, the custom button is dispbiyeti on the right side 
of the tx)nirf)ller liar, [ust to the left of the grow Ixjx. 



figure 4: The couiroller ixar’s a 4 Sf(m huiion 


The liutton contains a downward-jioiming triangle, which Ls 
suggestive of the triangle contained in a standard pofvup menu. 
This is largely becau.se the main intended use of the custom 
button was to allow the QuickTime plug-in for w^eb browsers to 
display a fxip-up menu of commands. Figure 5 shows a typical 
Quick'I'ime movie etiil>e‘dded in a web page, with the pop-up 
menu poppe'd up. 
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j. Sawp QiiicIrJimp Nome... 

■ - Plug ill ^ptliiigi... 

ftboul QiilckTIfiie Plug-iii... 

figure 5: The {Hp-iip menu of the QuickTime browser phfg-in 

Tlie Quick'rime public headers and libraries iimiain 
everything iliat we need to put tliis huiton to work in our own 
appiiaitiuns. Let s see how to do thuL The first thing we need 
to do is display the custom [>uiton in the conlrtrller l>ar that's 
attached lo our movies. We can use the function 
QTUtils^SliowConlrollerButton (defined in listing 7) with the 
consul nt mcFlagsUseCiisfom Billion to .show the custom 
button, like this: 

OTtJt 1 la_ShowCo(itrciii.e rButton (fic FI ag^^UseCustoinButton) i 

Then, all we need to do is intercept the user’s clicks on the 
custom button and react accordingly, litis is a task for our movie 
controller actitm filter function. We can add ihcse lines to our 
ever-expanding switch .statement in the filler function 
QTA f >[ C Act io n HI te rl^ roc: 

case ttcActionCustooiButtonClirk: 

QTCutitoin_HafidIeCu^tainBijrcanCl tck{theHC. tEventHecord 
•)U!eFarams, thefiefCon): 
br eait: 

So, when ilie function QTCustom_Iland]e‘CusU)miki!TonCiick 
gels callal. we know tlial tlie user h:is clickeil on the custom 
button in tlie t'onirf>ller bar, llie tliePanims piini meter to our 
movie controller aciitin filter function jx>ints to an evt^nt record 
descril:>ing that click. As you cran see, weVe casi the iliel^arams 
parameter to a I'Hanter to an event record and passed it to i>ur 
click-handling runction, 

At this point, we can call the Menu Manager funnion 
Popl.'pMcniLSelect to display a [Kjp up menu at the point 
specified in the event record. i^jpUpMcnuSelec i is very' much 
like the function MenuSelcru in that it takes caR^ of drawing the 
menu t>n the sateen, tracking iiiou.se movements witltin Lite 
menu, and llien returning to our application an indication of 
which item (if any) in the menu was .selected. If youVe written 
any .Matintosh applicatioEis, you are proliJohly already familiar 
with MenuSelecl, since you've almost certainly tLsed it to handle 
your application’s pulldown menus in the MacinLo,sh menu bar. 
But you might never have used PopUpMenuSelect, sini:e it's 
called internally by the Control Manager when you handle user 


actions on p<Dp-up menu controls. At any rate, it's just the 
function wc need here. 

Before we can call PoplIpMenuiielecl. however, we need to 
do a liTtle work. First, die jxiint c-ontainecl in the event leirottl 
passed to our action filter lunctlon is in ciKirdinates thuit are local 
to the window' assottiatetl with the movie controller. 
FopUpMenuSelect wanB iis input to l^e in global screen 
coordinates. So we need to call die LiK:alToGlobal function lo 
convert from die one coorilinate .system lo the other. Second, and 
more importantly, we need to gel a handle to the menu that we 
w^ant to lx: popped up at that location on the screen. We can do 
this in several ways. We cotdd just read tile menu from a re.source 
file (using the MacGelMcnti funajon)^ or we could build the 
menu programmaiicaliy on the fiy (using the NewMenu and 
AppendMenu functions). To make tilings easy for the moment, 
we'll use the latter medicxl and build the menu from .scratch. The 
complete QTCustomJlandleCusiomButtonClick function is 
shown in Listing 8. 

Listing 8: Handling clicks on the cRstnni button in the 

controller bar _ _ _ 

QTti LMom J landlcCustoml^ttonCtick 

void QTCiiKtontJIandl^CustoniButtonClicIt (MdvieControlIer theMC. 
EventRecord “theEvent. long theRefCon) 

tfpragraH unused(theMC) 

MenuHundie tayKetiu ” NULL; 

WindowObject myWIndowObject “ NULL; 

StrlngPti myHetiuTitle = 

QTUtlls_Cfinver I CTuPtiscaiStringtkMentiTi tie): 

StringPtr myXterolText ^ 

QTlIt t ls_CarivertCToPafidalString(kT 1 emlText); 

SliingPtr inyItem2TexT; ” 

QTUt i 1 fi_Co nv a r tCTcjPa scalSl ring (kit am2Text): 

StrlngPtr myTtetnlTexL “ 

QTUti 1 s ConvertCTo PasoalString(kite(ii3Text); 

BsyWindowObjeLt = UifindovObject) rheRofCon; 

if {myWindowObject “ NULL) 
goto bail; 

// maku sure wc jpn a ^’slid event 

it (theEvent = mUip) 
goto bail; 

// CTcait! a ni-w lucnu 

uiyMejui ^ NewHeiiu(kCustoinByttonKenin(L itiyMenuTitle); 

If (tnyKtmu != NULL) I 
long tsyltem = Oi 

Point tnypdint: 

// adtl sonit! items to the menu 
KacAppendMcnu(niyMenu, rayltemlText); 

MacAiipendNenu (myKetiu, myIteni2T(»xT); 

Mpi r Append Menu E my Harm, myltem’JTnxt): 

// in?^n Uic iitcnu into die menu list 
MacInsertMsnuCiDyManu, hiurMenuJ: 

// by dLf*itjrr, MacAppctidMcnu enaWes tJic item; 

// do am' desined menu iltui db^iililmg hcit 
if (!{*'myWindowObject).fIsDirty) 

DiaableManultemCrnyHenu, kSiivellcmindex); 

// find die kx-aikm of the mouse dkk; 

// die tofvicfi ccimcr of the pop-up inenu is ancbined at this point 
oyPoint = theEvent >where: 

LocalToGlobalf&myPoint); 

// displa)' pop-up nxriu md handle the item selected 
myTleni = PopUpMenuSeleet(iiiyMenu. ray Point, v* 
myFoint, li. Hiy11em): 
ijwitcb (KENU.ITKHfmyTtcn)) I 


26 


Movie Conthoi i.eh Pon>(}niRi 


MAdTECH • Fuiri arv 2000 




























case klteransd^x; 

QTF rame_B^^p(J * 
breuk; 

case kiteiii2Index: 

i[iTFraine_i>howAL tniiBox( J: 
break: 

case klteii31ndex: 

QTFrante UpdateHovleFlie [ (* ^TnyWindowObjocl) ^fWlndow): 
break: 

I 

// remove iht menu frrmi the menu list 
MacDeleteMenut'myMerm)»menuID): 

// disptMc cjf the mcim 
nisposeWenuCmyMenu); 

I 

bail: 

free(isyUenuTitie); 
free{myrteralText): 
free{ByItem2Text): 
f r ee{myItemlText): 

I 

Figure 6 sh()ws ihc pup-up menu displayed by a call lo 
QTCusiornJlaiKllcCustomButtonClick. 



About QTControtler.r 


H}>ure 6: Otirapplication'sauiom{.xjfMip numti. 

Ndw keep in mind iliai lIils is all Ijeing accomplished using 
APIs ihat lx:k>ng u> QuickTime and to the Macintosli Menu 
Manager, But the code weVe developed ciuiipilcs, links, and 
executes just fme under Windows as w^ell. I Find this just simply 
amaxing (but maylx.* I'm easy to aimze), Ar the very least, this is 
one mure example oFthe excellent work dune l>y die engineers 
who designed and implemented liie QuickTime Media layer 
(QTMl.) on Windows, wliich provides support under Windows 
for the parts of the Mucintosh Openiiing System and User 
IntcrFace d'oolbox that are used by QuickTime, 

SliLUCTlNG AN ENTIRE MO\TF 

You might have notk:etF when wc were discussing movie 
editing in the previous article, tlial there are movie conUoller 
hinctioas For fiandling all the sUindard menu items in liie Edit metiu, 
except For the xSelect All item. To fiandle dial iiem, we simply called 
tile applicjtJon<lefineil function QTFT[ik_SelectAllMovie, which we 
tlicl not discuss further. It's time to do so now, Ttie linear tiRivie 
contmller supports two actions that are useful here, 
mcAaioaSetSelettionIkgin and incActioaSetSelectionDurjition, To 


select the entire movie, as you've pnilralrly guessed, we can use 
mcActioaSetSelectionlWgin to set die teginning of the movie 
selcxtion to tlie beginning of the movie, and then we can use 
incActJonSelSeleclionDunition lo set ihc selc’ction duration to the 
duration of the entire riKwie. 

Tlie only issue left to consider, then, is ho%v to s^K^cify times 
in a movie. Time management is generally a big concern For 
multimedia content (as should l>e clear from the emphasis on time 
in tile produci name "QuickTime"). At the most basic: level, robust 
time services are necessary to get a video track to j)lay back at die 
right speed no mairer whal the pixjcessing speed of the user's 
computer. They are also necessary to maintain a precise 
Kymim>nization between sound and video tracks in a movie. 
QuickTime provides a numlier of limc-rc‘luled services, so time is 
something that well need to discuss more than once in this series 
of articles. For tlie moment, well IcMik only at wluU wc nc'ed in 
order to solve die problem at hand, Lind defer a more exhaustive 
treatment of QuickTime's time concefits to a fuaire article. 

The mcActionSetSelectionBegin and 
jiicAcTioniietSelectionDuraficm controller actions both take a 
parameter of type TimeRecord, which is declared like this: 

struct TimeR^coril t 

CompTimeValue va1uc; 

TiBeScale scale: 

TlmeBase base: 
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The products you need, with the prices 
and service you deserve... guaranteed. 


Power Tools for Programmers! 


Code Warrior ProfcssiDnal B put everything you rif?ed for 
^iOftwa^e devefopmeni at your fingertipsi project managemerl' 
tools, text and resource editors, source and class browsers, 
compilers, linkers, assemblers, and debugi^er.Rc[Gase 5 offers 
such features as RAD for Java, faster cornpite times, local and 
remote application debugging. IDE extensibility options and 
even tighter C/C+ + compliance. Additionally you can create 
applicatiorrs for Windows 9G/98/NT and Mac OS 8.x and Mac 
05 X from either host platForm. (available in versions hosted on 
Mac or Windows!. 



Bpottight is the first Macintosh "Automatic Debugger” it can 
automatically locate run lime errors in your code and display 
the offending source code line. Unlike similar tools on other 
platforms Spotlight is easy to use. No source code changes 
are riecessary for application debugging. Spotlight car] 
automatically check for wild pointers, memory leaks, 
overwrites, underwrites, invalid derefererreing of handles, and 
even toolbox paraineler validity checking - spotlight knows 
Macintosh verifying parameters to over ^00 toolbox calls. 





BugUnk Solo is a database dedicated to collecting and tracking 
problem reports. Ideal for the shareware developer BugUnk 
Solo allows you to distribute with your software Biigtink 
Reporter, which can easily be confiEurcd to allow your end users 
to send structured bug reports directly to BugUnk Solo, Promt 
users for exactly the information you need, send im midi ate 
report conformations, customize a new database to each 
project, search for related bugs with a simple query. To kif! bugs 
dead, you have to know where to find them. 



Rcsofccrer is the only supported gereral-purpose resource editor 
lor Macintosh. Rdicd upon by thousands of Mac developers. 
Resorcerer features a wealth of powerful yet easy-to-use tools Ibr 
easier, fester, and safer editing of Macintosh data files and 
resources. Whether you have to parse a picture, debug a data fork, 
design and cry out Baiioon Help, create a scripting dktionary, 
create anti aliased icons, design and edit a custom resource wilfi 
40,000 fields in it create C source code to run a dfeiog, or any d 
hundreds of other rcsourcc^related tasks, Resonoerer's magk will 
quickly save you time and rnonoy, 



VOOtXX> Server is a version control system for software 
developers using Metro werks Code War nor under Mac OS. 
VOODOO Server and the corresponding VOODOO clients (the 
included Code Warrior VCS plug-in and the VOODOO Admin 
applicationj are designed to offer reliable and robust version 
contfoi features while minimizing the administrative overhead 
that usually accompanies version control. If you re a single 
programmer or managing a team of developers, version control 
can make or break your project. Do it right, with VOODOO 


t)evelbpeh's^Phdifessibnial 


C+ + OevelopeCs Kit Standard was developed for everyone who, 
even without much knowledge o( C + + language or software 
developing, wants to know the C t i prograrTirriing language 
with applications In the OOSE C++ Developer's Kit explains 
software soTubons for C+ + developers, programmers and 
C + * students. 






Tools Pb^' 




Page Charmer 2.0 

$139 


Sciipter 2*0 

$179 


WebTen 

$349 


FaceSpan 3.0 WehSpice Animations 

ToolsPlus Lite $179 WebSpice 1,000,000 $89 MkLinux 


PowerKey 

Rebound 


$99 


$89 


$39 


$89 
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Master the Web! 



WebSTAR Server Suite is a complete set of powerful and easy-to- 
use INternei servers for iHe Mat OS Efforltessly serve web pages, 
host email accounts, publish databases, and share files - all with a 
single applicatiort on one Mac' VWehS TAR Server Suite is perfect for 
Internet or Intranet serving, single or multiple sites, small I and 
jlarge businesses it's power and ease-of-use saves any organization 
lime arid money 


Award'winning Freeway ^ .0 is slrntply the fastest and easiest way 
CO create web pages. Rcofessional web designers worldwide use 
Freeway with its support for CSS and HTML ^i.O, along with auto 
image slicing, image optimization, multiImgual ^ll-checking, 
HTML Import, built-in FTP. and an exciting new Actions 
terhnrtfoey to create and maintain leading-edge websites all 
witliour coding a single line. Freeway ships widi a SSO-page 
manual (5/5 - Computer Arts Magazine). Fitemaker tutorial, a 
PhotoDisc offer with free images and more! 


freewsy* 

2.0 




NetBamcr offers a Personal Firewall Anti vandal protection, and 
Intecfiei HlLefing Protect your machine from Intrusions by Internet 
or AppleTalk Incorrect passwords and individual actions are 
logged, you are alerted to hostile actions, and imruders are easily 
isolated Internet Filtering allows you to be sure that passwords, 
credit card numbers, and other sensitive information can never be 
exported from your computer - the content itself is filtered before 
tiny transfer! (Rated 4 mice by Macworld Magazine) i 


Funnel Wfeb Is the ufLimaie web analysis solution for professlonalsv 
Specifically designed for profiling web site usage and monitoring 
customer usage patterns. Funnel Web is ideal for examining server 
performance and oi^line effectiveness. Funnel web can analyze log file 
formats from any server, WebSTAR, Weblen, even Unix or NI hosted 
prvors. Discover (he most popular pages on your site, track server toads 
& optimize server pcfformanco, profile visitors based on organization, 
domain name, country, browser, clc. Funnd Web docs It alll 


WebSTAR;Seryer,;Suite 


Fmmwm 


..and great hardware solutions! 



2 USB PCI 




Add two USB ports to your older Maemtosh. Connect up to 
127 devices to the Universal Serial Bus (USB) that is 
Apple's new standard for desktop connectivity. USB mouse 
devices, keyboards., foysiicks. game controliers. printers, 
scanners - connect mem all to your current compulef. 
Installs in minutest 


Any serious gamer knows the superiority of the flight joystick. But 
until now, Mac users have been hard pressed to find a gaming 
joystick with the kick-butt power and resiliance they need The 
MaeSurfer USB Joystick fits mat gap with features like rrigger 
buttons, rapid ftre finger trigger, hat control, thrortfe, two way self 
centering, and complete customization for your game with the 
included Overdrive software. 
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A movie's time scule is the numl>er of units thnt elapse every 
second. Figuratively speaking, the time seale is Liie ruler by 
which the movie is measured. A movie's time scale Ls set at the 
time the movie is created and can be determined 
programmatically using the GetMovieTimeSc:ale hinc:tion. Like 
the distance between markings on a ruler, die numlxT you use 
for a Lime scale Is somewhat arbitniry% A standard value Is 600, 
w^hich permits non-fraclional values for most of the c:ommt>n 
movie rates (for example, a movie playing at 31) frame-S per 
second lias 20 uniLs per frame, if the time scale is 6(X)), 

Tlie values we specify in the value field are interpreted 
relative to the lime sc:ale specified in die scale fielcf The 
CompTimeValuc structure contains two fields, hi and lo, which 
sjxjcify (resj>ectively) the high' and low-order 32-biLs of our lime 
value, lb specify the l:)egianing of the mtivie, w'c need to set 
both of diese fields to 0, To si^cify die desired duration of the 
movie, we can set the lo field to the value returned by ihe 
GetMovieDuration function. Luckily, GeiMovieDuraiion returns 
the length of the specified rmivie in units relative to the movie's 
time scale. (The base field is not used here, .so we'U set it to 0.) 
Listing 9 defines the function Q'mtils^SelecxAllMovie. 

Listing 9: Selecting an entire movie 

Q'lll iUn_ScJcciAII Movie 

OSKrr QTtltHf! SelectAllHovie (HovieController theHC) 

( 

TlmeRetord myTlTiicRecord r 

Hov ie my Mo vie = MUlJ .i 

Comp0OBniRe suit ttiyErr noErr; 

if CtheMC -= NULL) 
roturotparflnErr): 

rayMovie = MCGeLMovie(TheMC)i 
if (myMovie “ NULL) 
return CparafiiErr): 

myTiaeRecord.value,hi * 0: 
myTimeRecord.value.lo 0: 
jayTimeRecord,base ^ 0: 

myTimeRecord. fsrale “ GetMovleTimeScale (ffiyMovie); 
inyErr MCDoAc Llon( theMC, aicActlonSetSeleetionflegin. 

^nyTineRecard): 

if (myErr !“ ooErr) 
return f(OSEcr)iiiyHrr): 

ayTimeRec&rdevalue,hi “ 0: 

wyTlifteRecord .value.io GetKovieI>uration(tnyMovle): 
inyTlroeRecord*baEe ^ 0; 

jnyTImeRccord.jfcale ” GerMoviaTimeScslefinyMovie) i 

rayErr “ MCUoArtlonftheKC, moArtionSetSelectlonDuration. 

AmyTlineRecord); 

retura{ (0SErr)iiiyErr); 


WoRKiNc; With Movie User Data 
A QuickTime movie file contains a list of data, called mame 
tiserduJ^. w'hich you can read and nianipulaie. 'Hils iisi consi.sts of 
individual items, each of whk'h has an associated type. Some ty|K-s 
of iLser data ane predefined by Quickrune, such as tlie movie s 
name, copyright infonnation, or author; other types can be defined 
by specific applications and used for their own purposes. For 
instanc:e, if you wanted to store die geograpMcal location of a 
QuickTime VR {xinorama, you could attach to the movie a piece 


of movie user data specifying die kKudon's latitude and longitude. 

A user data item type is a four-character code that looks like 
a resource type. For instance, the movie name user daUi item lias 
the type '©nam\ and the movie copyright user data item has the 
tyfie '€cpy\ In addition, there can l:>e more than one user data 
item of a particular type. If so, thtise iiems are dLsiinguLslied from 
one antidier by their index (which starts at 1), 

To retrieve a movie's user data item of a specific type and 
index, you first need to call the GetMovieUserData function to 
get the entire user data list from the movie. GetMovieUserUata 
returns a reference to die user data li.st; you can pass this 
reference to any of several other functions tliat retrieve 
individual items from the list. For instance, if you know' that the 
item contains text data, you can pass ihe user data reference to 
the GetUserDataText function to get that text data. Or, you can 
pass that reference tt> the Getl JserDatalteni function to get any 
kind of data (induding text data) from the user data list. By 
convention, the predefined types of movie user data are always 
stored in a big-endian format, mi we need tt> rc‘ineml:)er to 
convert the data from liig-cndian format lo the native-endian 
Ibnnat when we read the user data; we also need to convert the 
data from the native-endian ffirmai to big-endian ftirinat when 
we write the user data. 

Specify mg the Controller IV 

As mentioned earlier, any Quick'fime movie tliat uses a 
special movie controHer needs to contain a user data item that 
specifies which movie controller to use, Tlie type of this user 
data item is kUserllataMovielxininjllerType (defined in the 
header file MoviesJi as cly])'). Listing 10 defines the function 
QTl.ltils_Gel€ontrolleiTyix% w'hich returns the controller (ypt^ 
specified in a movie’s user liata, or kUnknownType if no 
coni roller type Ls spec ified in that user data. 

Listing 10: Getting a movie’s controller type 

Q'n 'libiJletConmjUtTType 

OSType QTUtils_CetControllerTyp(f (Huvii? ihoMovio) 

I 

UaerDara rayUserData - NULL^ 

OSType rayType ^ kUnknownType; 

OSKrr ray Err “ nciErc; 

/t miikt" sure we'R' a movie 

if (iheMovie = NULL) 
return {inyType) : 

myUserData = GetNovieUserDatattheHovieJ; 

if (inyUserData !- NULL) t 
rayErr = GetUserDataltemfinyUserData, &ntyType. 

gizeof(niyType)> kUserDataNovieControllerType, 0): 
if (tnyErr = noRrr) 

tnyType ^ EndiariU32_Rt oN f myType): 

I 

return(niyType): 

I 

Q l'Lftiis_GetConrrollerrype jusi assemWes the pic-ces w^eVe 
talked alxmt alxivc: it calls GetMovielJserData to get the movie’s 
user data list; then it calls GetUserDataltern to retrieve the movie 
controDer type user data item; finally, it tronverls the l>ig-endian 
user data to naiive-endian data using the macro 
EndianU32_BtoN. 
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Lut's look ai a saiiiplu iLse of Lho QTULiLs^CotControllcrTypc 
Function. Our basic frame work needs to know whether a movie 
uses the Qiiickfime VK jiiovie controller, since the Qiiickl'inie 
VR movie con I roll or does a lot of its own cursor management. 
When our a[>plication suirts up, and after it has ojx^ned llie 
movie hie, it calls the Qd LJriLs^lsQ JVliMovie function defined in 
Listing n to determine whether the movie is a QuickTime VR 
movie. As you can see, QTUtilsJsQWRMovio calls 
Q'lUtils_CetControllefrype to deterniine the movie's controller 
type and then compares that type againsi the cc^ntroller types 
that we know arc used by QuickTime VR movies. 
(kQTVRQ'y\lM ype is the controller type of all version 2.0 and 
later QuickTime VR hies, while kQTVROldObjeetType and 
kQTVIiOldPanoTypc' are controller types used i>y version bO 
object and panorama moviesJ 

Listing 11: Determining if a movie i^i a QuickTime VR 
movie 

Qllltils IsgiVRMovic 

Boolean QTUtils laQTVRMovie (Movie theMovie) 

I 

Boolean myTnQTVRMQvia " false; 

OSlTypn my Type: 

// (J'lVR nit)VTt.-ii [UVL a of user daui iIk iiKJviu ccininjlkT type 

myType ^ QTUtils_GetCantroilerTypeitheMovle): 

if ((inyType “ kQTVRQTVRType) || 

(ayType = kQTVSLOldPanoType) | | 

(myTyp^ = kQTVROldObjfictType)) 
mylsQiTVRMov i e “ true; 

return[myIsQTVKMQVie); 

I 

It's really just as easy to set a movie's eomrtfller type as it is 
to get a movie's controller type. Instead of calling 
GetUserDaLaUem, we need to call SelUscrDataltem, as shown in 
Listing 12. Notice tliat we make sore to con veil the type passed 
to us into big-endian format. 


Listing 12: Setting a movie's controller type 

Q11! lib SeiQjntrolkrTypc' 

OSSrr QTUtils_SetControll€rType (Movie theMovie. OSType 
theType) 

( 

UfTcrUata myaserData: 

OSErr myErr = iinErr: 

// niaki; sure wt'vc goi ;i movie 
If (theMovie NULL) 
return(paramErr): 

// j^^i tlu' movie's iLSCT daui list 
niyUfiorLala " GGLMovicUijeirOaLcittht^MovlG); 
if (raiyUserOata = NULL) 
return (puraniErr): 

rheType - EndianU 32 _NtoBCtheType): 
rayErr “ SetUserDataTtem(niyUserData. 

AtheType, sizeof(theType), 

ktJsarDataMovIeConr rolIerType, 0); 

reiutn (tityErr); 


There are a couple of points to keep in mind here, 
however. First, the SetUserDataItem function changes only 
the copy of the movie's user data tJiat's in memory (and to 
which myUserData is a reference). If you also want to change 
the user data stored in tlie movie file, you need to update the 
movie file tusuaUy by calling the Update Mo vie Re source 
function). If you were to call QTlJtils_SetControlIerType to 
change the movie's eonlroller lyi)e and then immediately 
closed the movie file, the new controller type would not be 
stored in the movie hie. 

Second, catling QTUti!s_SctControlIcrType does not 
change the mtnae controller associated with an open movie, 
unless you call it before you call NewMovieController. 'Hie 
rea,son, of course, is that NewMovieControlIer looks at the 
movie’s u.ser data at the time you call it; any subsequent 
changes to the movie data do not automatically change the 
movie conirfdler assigned to a movie. 

It occiLsiomiUy hapj^ns tliat you do want to change a movie's 
controQer type on the fly. To do tliis, you need to change die 
movie's y.ser daUi, close* ttie existing mtivie controller, and thtin 
of>en a new movie controller. You L'an accomplish ail diLs by 
calling the Q1LTtils_ChangeContioller'lVpe function delined in 
listing 13. 


GOT BUGS? 

...and you're drowning in paper 
trying to keep track of them? 

You need BusLink! 

> BugLink is a client/server application allowing you 
to connect developers, testers, and support engineers 
anywhere in the world. 

' Intuitive user interface gives you the information you 
need at a glance. 

' Fully customizable database— add the fields you need 
to each project. 

■ Custom TCP/IP protocol minimizes network 
traffic— ideal for dial-up connections. 

' Client applications can operate *off-!ine'— allowing 
bug entry and modification even when not connected to 
the network! 

' Cross platform-set up mixed Macintosh and Windows 
environments in minutes with no additional software 
needed! 

1 Try before you buy- Download and try risk free for 
30 days from http://www.pandawavexom/bl/ 

A 5 User License starts at $299; that’s only $60 per person. 

The PandaWave 

http://www.pandawave.conn 
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listing 13: Clianging a movie's controUer type 

dynamicgliy_ 

QTl ftils_('h:i ngeConimllerTyi’w 

Hq vieControiler Q'lUtils^iJh^ingeCatitr□ 1 lerType (MovleCon L roiler 
theMC, OSType theType» long theFlags) 
t 

MovleController nyMG “ NULL: 

Movie DiyMovie = NULL: 

Rect myRect: 

OSErr tnyErr “ noKrr: 

if make sure we've got a mtnie eontroller 
ii (theHC = HULL) 
return(NULL); 

// get tlie movie aj^odaied with Uiat eoiiiioller 
myMovle = MCC:etMovie{theMC): 

If (myMovie = NULL] 
reiurn(Nirf.L): 


Now we a\n define (in listing 14) :i fn net ion 
QTULils_GetMovieFi]cLotjpingInfo tlmt reLurns one of diese 
constants, depending on whetlier ii iind-s a movie user tkua item of 
tyjie LOOP' and (if there is one) on wliat llie tiim in that Itein is. 

Listing 14: Getting a movie’s looping state 

: i MoviclilckKjpiiig! nfo 

OSErr QTUtils.GetMovieFileLoopingInfo (Movie theKovie, long 
’thsLoopInfo) 

[ 

UserUaLa myUsorOaia “ NULL; 

long aiyLoopInfo ^ kNoLooplng: 

OSErr inyErr = paramErr; 

// sure wc'vo g^ji a movie 
if (theHovie “ NULL) 
goto bail: 


GetMovieBox [myMovie, tfmvRect): 

// sei lilt Qcw coiiirujUtr lypt in ilit movie s user daia lisi 
rnyErr = QTUtils_SetControllerType(iiiyHovie, thalype): 
if (inyEtr J“ ooErr) 
return(NUIX) * 

// tiisposc of thr existing contitilkT 
DisposeMovieCoritroller (theHC): 

// cR-aic a new coninillcr of I lie sptcifled lypt 

myMC “ NewHovleCont roller! aiyMovie. fcmyRect, theFlagfi); 
reTLirn(EayMG) ; 

1 

YoliII nt>licc Llial QTULils_(]liangeQjnLrollerType takes a 
movie controller, and not a movie, as an injiui parameier. The 
reason for this is that we need lo use Ixali ihe mtwie and ihe 
original movie conLtxjller within the funclion, and lhal we can 
always gel tiie movie cunently associated wiili a movie 
controller by calling the MCGelMovie function. There Ls no easy 
way to go in the reverse direction and obtain the movie 
conirollcr (if any) currently a>s.stKiated with a movie. 

Manipulating a Movie's Looping State 

Another standard use for movie user data is to specify a 
movie's looping state. I here are three possibilities iiere. First, a 
movie can play forward from beginning to end and then stop; a 
movie like this is said to have no looping*. Second, a tiiovie can 
play forward from beginning to end and then return to the 
lieginning and play forward again, and so on; a movie like this 
is said to iiave nonnaikK}ping. Finally, a movie can play Ibrw'ard 
from beginning to end and then play backwards from end to 
beginning, and then play forw^ard from beginning to end, and so 
on; a movie like this is .SiULl to iiave palindwme fooping. (Go 
hang a salami; Fm a lasagna hog!) 

A tnovie's looping state is specified by a user tlata item of 
type 'LOOP'. If tlic movie diMJsn'l contain an item of this iy[X\ 
then well assume that its looping state is no loofiing. If it does 
contain an item of this type, then the item cLita (a long integer) is 
0 for normal looping and ! for palindrome IcKjping. To make our 
work moix: i’eadai)le, let’s define iliree Itxjping slate consuints: 

emini I 

kNornglLooping ” 0, 

kfiilindromoLooping “ 1, 

kHoLaoping = 2 


// get the niovie’s uscf tlata list 

mytJseiDaia = GetMovieUs^rUaiii tthcMovle): 

if (myUserData NULL) I 

rnyErr = GetUserDatalteraCrayUserData. ^myLooplafo. 

sizeof(myLoopInfo). FOUR_CHAR_CODE('LOOPG. 0 ); 
ii (rnyErr = noErr) 

inyLaopInfo = EfidiaaS.l2 BtoN(myLodpInfoJ : 

I 

bail: 

‘theLqgplnfo = myLooplnfq: 
returnCmyErr): 

1 


When our apjilication opens a tnovie, it would be nice to 
set its looping state to the state indicated in its 'LOOP' movie 
user data iiem (or indicated by ihe absence of that hem). 
Happily, the movie controller supports two actions, 
mcActionSetLtK>ping and mcActionSetLtJOplsPalindrome, that we 
can issue to set the kxjping slate lo the correct stale. The 
mcAclic>nSeLL<x>ping action enables lcx)f)ing (3l any variety, and 
the mcActionSetLcxjplsPalindixxiie uclion enables palindrome 
looping. Listing 15 defines a HinciifXi ih:u we can use to read the 
ltK)ping information from die file and sel die appropriate 
l{X)ping state on the specified movie. 


Listing 13: Setting a movie^s looping stale 

> ’ti[s_Sc{IjQopingStatieFrf>mFile 

OSErr OTUills..S(?troopiqgStateFromFiTe fMovie rheMovie. 
MovieConirol1cf ihdMCJ 
I 

long myLouplnfo = kNoLoopirtg: 

OSErr rnyErr ^ noErr: 


tsiyErr = QTUtils GetMovidFileLoopingInfo 

ftheMovie, 


switch CTnyl.onpTnfq) t 


^myLodpInfo): 


case kNormalLooping: 

MCDoActiori(theMC. HicActianSetLooping. (void Gtrue); 
MCDoAction(thoMC. fflcAc tionSetLoop1s Pal ind come * 

(void *)false): 

break; 


case kPalindromel,Doping: 

HCDoActloid LlioMC. mcAcL i oiiSot Looping, (void Hi rue): 
MCUoAction (theMC, mcAcriouSetLoupliiRalindroiiie, 

(void *Jtrue): 

break; 


case kNoLooping: 
default: 

MCTloAct jon(thcMC, mcAct ionSetLoaptng, (void •JfalFSe); 
HCDoActioii (tiieMC, mcAc tiouSelLouplijPalind rojite, 

(void Hraise): 

break: 
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return {inyKrt) : 

I 

*riic last thing wc might want to do is store a movie's 
CLiiTc^iit looping Slate* in the movie file, WeVe alrcatly seen how 
to set a movie's mntroller tyj^f (Listing 12), so we might expeet 
to set llie looping slate in rouglily the same manner. However 
we cannot just add a TOOP' movie user data item with tlie 
aj^propriare cbita. since the nolooping state is indicated by the 
al>sence of such a user data item. What we need L{> do therefore 
Ls iijst remove any existing user data items of type TOOP’; then, 
for normal looping or palindrome looping, we can add a user 
data item of the appropriate type. Its easy enough to remove all 
existing tlems of type 1X>OP': just keep removing tlie lirst such 
item until there are no more remaining, like this: 

Diy Count ^ Count User Da taTypeCmyliser Data, 

FOUR_CHAR_CODE(^LOOP ')): 
while (myCount-) 

RemoveUsfttData(myttf.arData, FOim_CHAR_COnK( *LOOP'). I): 

The complete funclion for .setting a movie’s loofiing state i,s 
shown in Listing 16, 

Listhtg l6: Setting the lpq^ittgj|ta.te of a 

QT1 ]tils_.SctMn vi t Filol.<>c)p i n)?lnfo 

OEErr QTtltlL«T SntHovitiFileLoopIn^Info {Kovte r.hRHnvie, long, 
Th^;LoopTnfo) 

! 

UmerllaLa tKvUserData - NULL; 

long myLoopInfo: 


□hori myCouni ” 0: 

OSKrf iityErr = pararaErr; 

// gjL t tht movie's user data 

rayU s e rOat a ^ GetHov i etJ s e r Data (t h eHovi e): 
if (mylJserData — NULL) 
goto bail; 

// wt* want to end up with ai mo?a ono user dam item of type 

// so iHts rt'movt* any twisting ones 

myCouriL = CounLUaerDaLaType(DiyUif£}rDati], 

F 0 UR_CI 1 AH_CQDK( )): 

while C my Count—} 

Re]]ioveUsei:Data(rayUserData, F0UR„CHAR_C0DE( TOOP'), 1) | 

// make suru we're writini* big-endian dan 
myLooptnfo = Endifln!J12,NtoB(theLoopInfo): 

awlLcU tLhoLooplnfo) [ 
ease kNorJEEilLooplng,: 
case kPailndromeLoopinfi: 

jnyErr ^ SetUserDataltemtrayUserData. ^myLocplnfo. 

fiizeof[Iona). four CHAR^CODE(*LOOP'), 0)r 

break: 

case kWoTtoaptng: 
dcfau.1 L: 

niyErr = imErr ; 
break; 

1 

ball; 

return(myErr): 

) 

Once again, we'd need to make sure to call LipdateMovieResource 
to update the ii.ser clata in the movie file or oiir changes to the 
user data will Ikj lost when we clcise die movie. 

















Getting a Movie's Stored Window Position 

1b finish off our advenaires with a movie's user ihm, let’s 
consider briefly hcjw to get the stored screen position of a movie 
window’. A movie’s user data list can contain an item of type 
"WLQC’, whose accompanying data consists of a 32-bit value that 
is inteipreted as a point that specifies the position of the upper- 
left corner of the movie window. Listing 17 shows tlie function 
Q1lltiIs_GetWindf)wPositiQnhromi*iIe, w^hose definition should 
be completely familiar to you by now. 

Limiting 17; Getting a movie-s stored screen position 

Q'l t J lils_GLl Wi nilt) wPosi tioi i Jit)m 1 1 lu 

OSErr QTUtllE^GetHlndavPositionFronFiie {Movie theMovie, Point 
'thePoint) 

I 

User Data inytlserDHta "" NlM-h; 

Polni myPoiril ^ IkDelauliWlndowX, kDofaullWindowYl i 

OSErr JiiyErr ^ paramErr: 

// make sure we Ve got a movie 
if (theMovie -- NULL) 
goto bail; 

// get Lilt: movie's astr data M 

myUserData = GetMovieUserDataftbeMoviE;); 

If (tuyUscrnaLa NULL) ( 

myErr = G^i^iU^3^?^^aiilHonl(1l!yil!3:t’^l>Eila* SrnyPoUit. 

sl^eof {Point) ♦ L‘OLIR_GI3AE_COD£( ‘WLOC’), 0): 
if (myErr ^ noErr) ( 

myPoint^v ^ EndianSl6_BtoN[iiiyFoijit .v): 
my Point ih = EndianS16_BtoN {inyPoint .h): 

I 

I 

bail; 

•ih^Polnt = myPoint: 
return (;ayErr); 


In theory, liefoie oiieniog tlie movie at ilie window [josilion 
returned by Q'ri[tils_GetWindowPosilionh'romPilc% you should 
verify that that |x>siiion is reasf)nal^ie for ihe ('omputer on which the 
movie is Ixing ofxaied. Oiherwisc*, the new' movie window' might 
not lx visible. 11iis sanity check is left as an exercise for the reader. 

Keep in mind that you cm kxjk ft>r any of the predefined 
types of movie lisct data, and you can dellne your own types. 
You'd retrieve your own custom types of user data items in 
exactly the same way that we’ve retrieved tlie types defined by 
QuickTime. Tlie only restriction is that A[)ple has rcsencxl for 
itself all fourxharacter types that consist solely of lower-case 
letters an<f .special chaniaers. So, for in.srance, you shoulcin’t use 
'bill* as a clisLojii user data type, but you're free to usl‘ 'BlLi;. 

I know' what you’re thinking: what about WLOC’ and 
Shouldn't they instead be 'wloc' and loop', to ht within 
A[>t)le's reserved types? Indeed they should be, // they were 
predehned user data tyjxs. Bui tliey aren't; you won t find 
‘WLOC or 'LOOP’ defmeci in any Quicklime header file. Kather, 
these types were used as c ustom types early on in QnickTIi'ne's 
history by the application MoviePlayer. Other applications 
ibllow'cd suit, and these iwc^ types liave Ixcome accepted ways 
of saving a movie’s kx’aiion and Imping states. 

Opening URLs 

Txa's finish up with something cx)mpletely c:cx>l and incmdibly 
easy to do. Namely, let's liave our apf)licalion tell tlie ustT's default 
web browser to open a web page in a hiiowser window, nieie aie 
quite a few reasons you might want to do this. For one, your 


a[plicatiQn might have a "I lelp" menu item (or perhaps a Ixitton in 
your Alx^ui Ixx) to send the iLser to your owm weh site, .so that you 
can provide up-lcxdalc irifonmilion alxjut your f^rcxlucl. Or, you 
niigiit detect tliai tlie user’s machine is lacking a decompressor 
needed for .some cLit:! In the movies you want to play, so you w-ant 
the user to download the necessary files. For whatever leason, it's 
just ]>lain useful to have at your disposal iin easy way to open a web 
brow.ser and display a given LfliL. 

How easy c:an this be? Well, assuming tliat myMC is an ot)en 
movie controller and that niyHandle is a handle to block of 
memory that contains a null-terminated siring reprei^enfing the 
UBT., it's just this easy: 

MC D 0 Ac t iaJ3 ( my HC» jiil Ac t loiiLiiikToOEL * ( vol d ') my Hand 1 e); 

That’s right: with one line of code, yoiiVe in.stnjcted the movie 
controller to launch the user's ddault weti browser (if it isn't 
already open) and display the s]:)ecified URL in a new windowc 
Of course, there is undoubtecliy .some more ccxle required to get 
the URL into a liandle (supixising lhat il Ixgaii its life as a typical 
C siring of ty|>e char *). And, as weVe seen, there’s a fair amount 
of code required to open a movie and associate a movie 
controller with il. Bui once we’ve done all lhai w'ork, it's nice to 
know that we can leverage it to good effect. 

But you might be wondering: whnt il' we don't have a movie 
controller at hanti (maylx we tlon't have any movie windows opc‘n 
yet)? ’'^hat do we do tlien? Well, we can sim[>ly open a movie 
controller. As we mentioned earlier, a movie controller is a software 
comt'K)nent that managers a user’s intenrciion with a movie, 
Actoidingly, we cun use tlie CxjrnponenL Manager to 0|X!n a movie 
conUoller, wliellier or not we liave a movie to athidi it to. 1b do 
this, we just call the Component Manager's 
OpenADefaiiltComponenl function and specify that w'c want an 
insiLince of a conifxinent of lyjx Mt)vieContnilleiGoni|X}nemType. 
Listing 18 shows tlie complete function that takes a C string 
spec ifying a URL and does all the work necessary' to opcai tlie 
sixcified URL in the Liser's default weh brow'ser. 

lisdng 18: Opening a URL 

QTApp^H iH-cUro wserOpenl JRl 
OSEtr QTApp_HtiveBrow;^ctDpcttURL (char *tlieURL.) 

I 

MovieController royMC = NULL; 

Handle piyHandle = NULL: 

Size mySize ^ 0; 

OSErr wiyEfr = noErr: 

// ctjpy tlx spedJled 1 JRl. inin a hanclk* 
niySize ^ [Size)strlenIthoLIRL) + I: 
if CmySize = 0) 
goto bail; 

// ;l1Uk::iLc! a tn:w hantJle 
inyHarirlle = NKwHandleClear (iiySize): 
if (myHanrtle = NULL) 
goto ba n: 

// copy ilic OKI, Inio ilic handle 
BlockMoveCtheURLH ‘inyHandie. niySize): 

// instantiate a movie contrf>lkT and send it an mcActionl.inkToURL message 
myErr = OpenADefaultCoinpQneiit 

(MnvieGontrollerConiponentTypfi, 0, &fflyMC) ; 

II [myErr I" iioErr) 
goto bail: 

inyErr - MCDoActJLon(ioyMC. mcActionllnkToURL, 

(void *)rayHandle): 
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hai l: 

If (myTlaiidle mU,) 
iHspospHandlcfifiyHacidle); 

It (niyMC 1“ NULL) 

CloseCDJnponent (inyMC): 

retutn(nvyErr); 

] 

This is a guncrally LtscfLil Lccliniquij Lo add lo your l)ag of 
tricks: if thcie's a movie coniroller action that you’d like to Issue 
but you don't have a movie controller close at hand, just call 
OpcnADcraulLComponcnt io get yourself a movie controller, 
issue tile action, and tlten dispose of die controller. Movie 
controllers don’t actually have to be controlling movies for us to 
put them LO work. 

This Moni h"s Code 

The Code folder accompanying I his article contains the 
project files, source code and resource data ol'a sample apfilication 
called Q'fController, for both Macintosh and Windows. 
QTController is just like the QTShell applioitinn we considenecl last 
intmlli, except tliat tlie Test menu includes items tliat illustrate 
many of die tecliniques involving movie contrcdlers diat weVe 
learned here. Figure 7 shows the Test menu of QTController 
wlicn a QuickTime movie Is in die fnmmiost window. 



Hide Controller Bor 

mt 

Enable Badge Display 

m 

Put Controller Bar On Top 


Hide Speaker Button 

^4 

Hide Custom Button 

m : 

Hide Step Buttons 

m 

Hide Back Button . 

mi 

Hide 2ooni Buttons ^ 

; 

Hide Hoi Spot Button 


Hide Translole Button 

m 

1 Bromse nniiiii.apple.cDm ] 


Ftgure 7: Ihe les! menu in QTCoyilroUer 

The source code for QTController is just the soume code for 
Q'l'Sliell, with modifications made to two functions only, 
QTApp_Han<ileMenn and QTApp_AdjustMenus (in 
ComApplication.c). In addition, Lite file QTCustomBullon.c has 
lieen added to die projects. In all otlier respects^ QTSheD and 
QTController are identicaL tWelh actually that isn’t quite true; 1 
took die opixirtunity to fk a few bugs in the underlying 
framework. If yotfve started your ow'n projects Ixised on 
Ql’Shelh you should use the files in the Common Files folder 
included this month ircsiead of die files provided last niondi.) 

Conclusion 

After all this discussion of movie controllers and the 
things you can do with tliem, you juight be wandering 
wliether it’s possible to play hack movies without the 
assistance of a movie controller. In other words, do we 
always have to have a movie controller lurking around 


somewhere? The answer is: yes and no. Some types of 
QuickTime movies require a movie controller white others 
do not. Standard linear Quicklime movies can he played 
back without the assistance of a movie controller, but of 
course you’ll Jiave to do a w'holc lot of work to replicate die 
user interaction normally provided by the movie controller. 
Other types of QuickTime movies, such a.s QuickTime VR 
and wired sprite movies, must have a movie coniroiler 
associated with them. 

What's distinctive about the types of Quickl ime movies 
that rec|uire movie controllers is that tlicy are by nature 
highly interactive. You don’t just sit back and watch a 
QuickTime VR movie; instead, you actively navigate within 
the node and within the mu I Li node secne. The same is true 
for wired sprite movies: by and large, the real iJiipaci of a 
wired sprite movie arises from actions the user performs with 
the mouse. This isn't to deny that you could construet a 
QuickTime VR movie that navigated itself, sort of like a 
guided tour tlirough a house or museum and which therefore 
was minimally interactive. Bitt you couldn’t manage the self- 
navigation w ithout a movie controller, 

Still, some kinds of movies can be played back a la carte, 
as it were, without the assi.sLance of a movie controller. In the 
next article, well take a look at how to use QuickTime’s 
Movie Toolbox to do thk and at some of the rea.son.s you 
might w^ant to do this in the first place. 
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Conliniied from page 4 

l.ike a Pix^ir movie, whk:h c:iin he waLehecl ^nti 
thorou^liiy enjoyed by anyone iVoni age 2 to LOO, ilie new 
Mac ex]ierience is b^si expressed as serions and powerflil 
tcxils that are bin Lo use. Tools thal capliire that childlicxjd 
sense of discovery and play that is what dnves so many 
of us> It was the.se attributes that attracted many of us to 
Apple and the Mac in rlie first place. Anci it was the 
tneinory' of them that susiained many of us during tlic 
darkest moments of the last-half decade. 

For this retison, it i.s with all resfiect that f shout: 'the 
Jim is hack!" 

Mac os X — In Our Lifftimf. 

Mac OS X has had a difficult and painful gestation to 
date, rroin its genesis as Rliaps^xly it has lieeti — cjften 
rightfully so — greeted with skepticism and even — if we 
mosl Ik- lionesi — a lithe ridicule. 

ITese attitudes seem to he changing. And changing 
for good reast^n. Apple has shipped two devek^per 
releases of Mac OS X and iti Sieve Jobs' keynote at 
M ac Wt jrid d ei i u j ns t ra ted a ct) m ] >e 11 i ng p re-re I ea se t >r M ac 
OS X and its new user experience. 

In fits keynoie demonsinuions of Mac’ OS X. Steve 
Jobs clcnionslialed a number of features cjf Mac OS X. Tfie 
two demos that caught my eye most intensely, were the 
vaiious cleinonsinuions of the Quartz graphics engine and 
of the Classic, Cairhon, and CcK’oa Al^ls. 

Working on Qiraitz are some of the hottest and smaitest 
graphics programmers in the software industiy, and il shows. 
The Quailz demos llutl we saw^ showetl a graphics engine 
iliat isn't just ^'Whai-Yt)LKSee-Is-Wtrai-Yt)u-Gei’\ hut rather, 
“Whal-You-See-ls-What-VoirWant/' With its .snappy on-the- 
fly rendering, anti-aliasing, and tninsparency, il showed {hat 
Apple is delniilely going to set a new^ standard in jx-iTional 
ccKiipiiter graphics when Mac C.)S X ships. 

Hie qiiality' and tldeliry of the gmphics experience 
delivered by Quaitz is outstanding. Mow far it is ahead of 
today’s jietsonal computer graphics reminds me of how far 
ahead the ongtnal Quickl‘)raw or Color Quick! )riw were 
w hen lliey were Ursi iniroduceeL Tliis Is definitely going lo Ix^ 
feitile gixHtnd lor deveiojx^is to build fun new sothvare upon. 

Giving a demo of an API isn't an easy task, hut it was 
done convincingly by Steve Jobs by sliowing olTa Clas.sic, 
Carbcai, and Cocoa application one after the other. 

I'o demonstrate Cia.ssic, he double-clicked on an 
uni nodi Tied veision of MkTtxsofi Kxeel and it lautiched 
quickly anel painlessly. What was must stunning was wliai 
wasn't tlierei tlie Blue Box, ratlier tlie application was running 
in the Mac OS X Finder along wiili any oiherapplieaiion.s iliai 
were Uiere. If die lack of any kind of "conifxilihiliLy ix>x” was 
the cake, die icing on the cake was liow quieldy die 
application launched: it was faster than Mac’ OS 9. 


Now, 1 am very skeptical — having been burned 
more than a few rimes in my ycKinger and naive days — 
when anyone says, "^This is a better X than X!” No one 
from Apple said that, but what they demoasiraled was a 
new operating system, with totally new^ plumbing, that 
launetied today’s Mac applications fa.sLer than Mac OS 9* If 
Apple's goal is to make this transition as gentle and 
painless as pos.sil->le, then they are on the right track. 

Next up was the Carbon API, which was built around 
a demo of internet Explorer 3. What made this deiiio very 
interesting is that the Internet Explorer team, accorcling to 
Steve Jobs, has been working with CarbonLih on Mac OS 
9. They hadn't seen this release of Mac OS X or the new 
Mac OS X user interface, yet when double-clicked; 
Inrernef Explorer launched and was sporting the new 
Acjua user iniei face. 

If this behavior holds true througli to final, it means 
we can start '‘carbonizing" our applications today as pan 
of the development of our lale.st release and our users will 
be able to tiin them on Mac OS X. A CarhonLib that truly 
works this way will lx, for the Mac OS X transition, the 
moral ec]uivaleni of the 6HK eniukiior in the Power Mac. 

I'ii tally we gcM to see llie Ccxoa API in action when Steve 
jolis demonstraletl an improved NeXT Mail Viewer iiinning on 
Mac OS X. TIutc are two interesting facts to note alxHii ifiis 
Liemo. First, at last report, only one develo|XT is working cin 
MailViewer, liut it definitely demonstrated substantial new^ 
fundionnlity as well as the Aciiia ink*ri'ace, Second, also at last 
re|K>rl, MailViewer is still develojxd in ObjecLive-C]. This 
means that those that would nither "fght than switch" to Java 
will be able to continue using their ( K )l* language of choice 
For <|uite some lime. 

One point stressed lliroughout the API demos was 
thal A]iple views the move from Classic to Carbon and 
from there lo Ccxoa as a migration. Unlike all of la.st year 
when it was '‘Ckirlion, Carlmii, Carbon!" and Cocoa was a 
footnote, if that, in order to reassure the existing Mac 
dt^veloper ba.se, Steve Jobs was up-front that Apple is in 
the piocess of making an API transition and that the future 
itiai he sees is Cocoa-navoiecf 

Steve Jobs also outlined a schedule for Mac OS X with 
the Ibllowing major iiiilesiones: 

Final beta release to developers — spiing c^f 2909, you 
c':in bet that this will probably be at WUTHT 

M ac OS X available in stores — summer of 2000, 
which I believe gives them until mtd-Sepienilxr to ship it! 

Mac os X pRFdUx\DFD on Aix Systems — January 2001 
So, why sli<3iild we believe this sdieLlule, when we have 
been hurtled in tlic past? Lfiililte tliose in tlie past, this 
.st'hediile was backed up not jusi t)y hand weaving, t>ul l>y 
meal in Uie IbriiLs of solid deiiUJs and two earlier ‘‘ITevelojier 
Previews", llie general tone of developt^rs in contact witli 
Mac OS X, tip<jn hearing this schedule, was not skepticLsni 
and rampant cynicism, but rather guarded optimism. 
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\m(±^ if 1 had to |>lace a bet, I would predict 
the folkiwing: 

We will .see and be .seedetl wiih the litial l>eta of Mac 
OS X at wwnc. 

Apple will s1h]> Mac OS X. release I late ibis siiiinner. 
Il will be gobl:»led up l>y early atloplers who will shake it 
out. 'rhe early adopters — and I plan to lx* among them 
— will a(t as an unpaid QA depanmeni and will hel[) 
Apf)lc to klentify the areas in Mac OS X in need of 
iinpr<»vemeni feff>re ir goes into wide circulation. 

We will al least one inierim relea.se of Mac OS X — 
incorfx>rating a fair amount of bug killing — before Apple 
starts pre-Ujading it on al! systems in Januaiy 20Ui. 

The iIVL\c of II.sfr Intejetaces 

Also in his keynok-% Sieve joks inircKluced the next 
general if jn of the Mac user interface called Ac|iuu Like 
tlH7 iMac\ which shattered our preconc'eptions of what a 
coiii|>Liier should look like, Aqua sha tiers our 
preconceptions of what a ctanputer interface should look 
like and how it should beltave. 

Many Mac users anti tievelojxrs were anxifHJ.s aliout 
Mac OS X's user inierfacc, as they imagined a NeXl’-like 
WfJrkspace or Quick'llme 4 user interface lK;ing hjisted 
upon them. Well, this isn't I he case and it shows the 
newfound maturity of Apple in teims t>f listening lo tls 
cu-siomers. We can only hope that this 

Like tlie iMac before it, Acjua is ihe kind of industrial 
design whose introduciion will reverberate through out 
entire imlustries. It will reinlorce the trends, siancd by the 


iMac, Um^ards mixing power, ease-of-use, and fun in a 
single pac kage. As I said earlier, "f’he fun is back!” and 
Ac|ua is just one example of this reality. 

Bfyoivi) the Box & iiie Mac Portae 
T he theme of Steve Jobs' keynote was "‘Beyond the 
iiox”, by which he was communicating tliat Apple is 
more than ju.st a make tjf liardw^are. Rather they are 
wx>rking to create [>ruducts that create a top-notch 
experience for their customers starting with the hardware 
and moving out onio the InierneL 

While a desitv U) gel some ot an “Intcrnti” valuation lor 
Apt^lc's stock and the fact there wasn't any new hardware 
Uj intro may havc^ played a factejr io the fexus on ‘ikryond 
the Box”, the fact is that Apple neetU to Ik* more than a 
maker of ccxil hardw^are. The heart and mjuI cjf the Mac has 
always Ixvn more alxjut soriware than alxmi hardware. It 
is gocxl that Apple and Steve Jofe understand this and are 
c'learly cotunuinicating it to the w^orld 

Moving Ix^yond Quic’kTime, Mac OS 9, and Mac OS X 
— wliich it f:an be argued are part of the "‘I'hjx experience” 
Steve jobs unveiled the revamped apfjle.com, as the 
Inst concrete example cjf Apple's locus “Beyond the Box”, 
Wliat Apple has created with the new Apple.cfjm is 
l>olh a deslinatHm for non-Mac users on the Internet — 
with its iC!ards and (Reviews — that will give ihem as 
foretaste of the c|ualily of the "‘Macintosh Way”, as well ;ls 
creating a unique experience for Mac u.sers (al Ica.si those 
waili Mac OS 9) that leverages the Mac OS to ileliver 
services with a level f>f integration that isn't available 
anyw'here else through their tTools* 


C++ Developers Kif 

Advanced Tools for ANSI C++ Development 


Professionai includes 

■3 CDs 
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-! UMUC++ Quick 
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"The C + + Developer's Kit is a tutorial and 
reference collection showing programmefs 
how to create better ANSI C++ code* 
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powerful, and reliable applications 
for any platform!" 





ISO 

ANSI 

C++ 


dt'XTjmx^f's 



wwwJ0Chnosoftwebxom 

d^rsi^eQhnffspftwfh- com 
















Jf the iMac Is alxiiii getting on die Internet in three easy 
steps, ihen a Mac plus iTcx>ls is alx>uL getting on the Internet 
and using with a level of s<)phestication and fx>wer that isn’t 
possilile for the average u-ser on any platfomi. 

If this generation t>f iTtK)(s is the foreshadowing of 
what it means for Apple to move "‘lieyond the Box‘^ then 
the future of Apple and the Mac on the Iniemet is going 
\a lx* very interesting and provide a many opportunities 
ftjr the c’ompetitian to copy, 

C(K>1 that fits in your paliu 

If Mac: OS X is going to be the place innovate on 
the desktop going forward, then it finds true liandheld 
counterpart in the fiandspring Visor. 

The Handspring Visor was the most have hit of the 
show, Everywiicre yon went, you saw' peo(:)le using 
them or lining up to l>uy them. Why? Because it 
delivers all of the functionality of the Palm Computing 
handheld in a cooler looking, cheaper package wliich 
packs the Springboard expansion slot. 

Building on the Springlxjard expansion slot a 
developer can add a mfKlem, a game, a GPS devic^e, or 
any number of otlicr additions, to a Vison It providc-s an 
easy and clearly defined way to expand the Handspring, 
so liiai ft can he more than a “Daytimer on steroids". 

The Springboard expansion .slot j^rovides the 
tjpporUinity for “system I racking” that tixtensions do on 
today’s Mac OS, I expect over the next year that we 
will sec an incredible amount of useful and useless 
expansion modules tlral will make the Visor the most 
ftin handheld on the market. This fact — along with it 
being cheaper and cooler looking — points to control 
of the Palm Irardware platform passing from l*alm 
Clomputing to Handspring. 

Metrowfrks IJ FOR You? 

For its humble beginning as a vendor of Pascal and 
Modula-2 compilers for the educational market, 
Metrowerks lias alw^ays .seen the key to selling more 
developer tools as getting more people programming. 
For thi.s reason they have always focused on creating a 
version of CodeWarrior and various supporting 
products that liclp non-programmers get a solid start 
writing .software. 

MeirowerksU — www.metrowerksu.com - is their 
latest thrust in this area. It is a w^eb site that provides 
free courses in using CodeWarrior, prognmiining in 
C++ for Mac and Windows, and Java development. Of 
course, to take tliese classes you will want to buy the 
latest and greatest version of CodeWarrior. But maybe 
that was what they were thinking? 


Problems & OppORTuixmEs? 

Walking Uie flcxir of Mac World Fxpo it was easy to ccjme 
across a couple of signs that at first blu-sh point to things not 
l>eing perfect in the land of Mac, hut when flipped on its is a big 
opjx)rlunity for the Mac market. 

First, was the nunil>cr of open spaces one came across 
walking through the North Hall. While the .MacWorkl Expo 
staff did a yeomen job of filling them in and hiding them 
w-ell, in the procc\s>s providing a much more comfortable 
environment for those with tired feet, it is clear that the 
number of companies with a “big tent" pre.scnee was down 
from previous years. This was in part offset by the shear 
number of companies that one found in the various pavilions 
.scattereti over the show floor. 

One can only hope that many of the companies that arc 
entering for the first time or renewing their presence in the Mac 
market via one the MacWorld jxtvilioas will graduate to a “big 
tent" presence at future Expo. 'Ihere is a definite op|Xjrtuniiy for 
MacWorld Expo and A[)[)le \o work together to ufvsell these 
companies into a bigger presence at future Expo. 

Next was the visible lack of free Mac progmmming 
talent. In contrast to a I'ew^ years ago, when you would see 
experienced Mac progratiimer.s trolling the aisles of 
MacWorld Expo Linsuccessfully searching for jnlis, this year 
companies were actively trolling for talent. It was not 
unusual to hear from a fellow' developer that they were 
nm.sidering multiple offers. 

If you are a company with a presence in or trying to 
enter the Mac market, this is Ivad news. But if you are looking 
at the overall health of the Mac market, this is a very positive 
sign. It means that a lot of companies arc developing a lot f>f 
products for the Mac market, 

llie downside of ihis shortage of Mac progmmming faleni 
is I hat it could — in time — stall development of new Mac 
products. To keep this fn>m h:ip(:jemng, we need to build a 
“farm system” that will help develop prfimising Mac 
programmers that are still in school. Ap[ile tcxik a grot first step 
in this direeiion by establishing the student devclof^er program 
a year ago. It would Ik* grc^iii to seem take more steps in this 
direction. Perhips they couki create a “Introduction to Mac 
Prt:>gramming" cour.sti in collaboration with MeirowerksU? 

The Bo j l OM Line 

First and foremost, there was a lot hai^j^ening at MacWorld 
SF 20tX). More tlian 1 could dej jiLStice to a report twice as long. 
Be it the bigger and brighter presence of ftEAliioftware with 
their late.st release of REALBasic, the presence cif industrial 
quality ODBC drivers from Merant — finally! — or tlie 
rnnumemble other things tlial I have failed to mention. 

That said, the bottom line out of MacWorld SF 2000 is that 
tlie Mac platform is alive and well. Yes, things aren't perfect — 
are they ever — but on halanc:e, life is good. We are no longer 
on life support or in critical care a.s we were a couple of years 
ago. And as a bonus, not only is life good, but it is fun. U 
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Macworld Expo for Admins 


Wlmt is there at a consumer show for 
the IS professional 

OlTilVIFW 

Ol>viou.sly, Macworld Is a ixinsuriicr’s paradise. With every 
kind of sparkly imaginahle, from ihe highest — tech non-linear 
editing system, io tlie most low — tech plastic lener opener, 
(AKA, the infamous iShiv), Macworld is a glittering paradise of 
dazzling toys to entice ific eye, an hopefully the wallet. 
However, althougli anyone frotii the consumer, educaiionah and 
artistic markets are going to feel right at home, tJiea* is a fourth 
market tltat feels a htl lost, and inaylxr ewen shunned at such an 
event. I speak of course of my own commuoiiy, ilie IS/IT 
cxanmunily. Is Macworld (ust a waste of time for us? Of course 
not, and hopefully, this artick^ will give MacTech's reiiders an IS 
eye's view the show, and even Ix^tter, get more IT into future 
sfiows (not just in San FmncLsco, hut in New York us well), 

1 will cover certain pans of the slu}w chitinologically, but in 
general, 1 will just point out items of interest as 1 saw them. 

Pre-Show CoNFERtNCts 

Ihe first thing I have found Is ctxat a G5 Fowerlkx>k Ls NOT 
the thing to carry if you want to go through seciuriLy dicck[x^ints in 
a liLUTy, Evidently the design is rjuile noticeabie on tlie x-ray 
miichines, and I spent al)out 5 minutes each way having my 
hic'kpack ‘searcltcxl; read: My PowerFkx>k ogled liy a suri)rising 
nuiulxT of fans, 1 iimgine ifitxjk owners having llie same prol^lem 
Tlie pre-sliow conferences are an odd mix of interests, w'ilfi 
everything from novice-level classes on hoW' to be a ptmer user 
and beginning AppleScript, lo using die Apple Network 
Administration TfK>IKit, (ANAT). I attended the Beginning 
AppleScript session, given by the AppleScript Prxxluti .Manager, 
Sal Soghoian* Although I have been scripting for quite a few 
years now, I have found that ,seven hours with Sal will always 
give me some new iidl)it that I may not have otlierwise picked 
up. Regardless of your .scTipting experience, Sal is one of the two 
or thiee AppleScript 'gcxls", and any ses.sion of liis is w'ell worth 


the effort, (Sal is also one of the more gracious folks 1 know, 
giving my session on AppleScripiing Networks a few veiy 
appreciated plugs/) In this nise, the suqsrise w^as some very 
interesting demos of the U|)coming QuickTime 4, Ts scripting 
capabilities. Although not itiimecliarely apparent to a network 
admin tyjx.\ Sal's demo of using QuickTime 4.rs scripting 
capabilities, anci M:t<' OS 9*s tmj)roved speech rectignition 
shcjwed how you c-an create stjme very itnpressive help systems. 
Althougli the Mac has long had the best rmliiic help gt>ing, Sal 
showed how you can link c lisUjiu Qukk14me movies to various 
help me.. / phrases lo crc'ate assistants that show tlie user how 
to perform a task in an eiisy to follow system of movies. Much 
nicer than even Applt‘ (hiide/s coach marks, and consiclering ihe 
amount of time spent in showing users the same basic functions 
repeatedly, one worth kxiking into, 

Sal also demonstrated Ma<- OS 9/s new AppleKvents over 
TCl^'IP capabilities, and again, fora netwxirk admin, gelling tlic 
same .scrij)ling functionality from TCIVIP as we liave with 
Af>pleTalk is a good ,step in moving your network closer to full 
TCIVIP usage. This also brouglit up some security issues, which 
are well wonh considering. While it Is inie, as Saf and many 
audience membeis pointed out, that A(>pleSchpt can destroy a 
computer’s data faster than any odier xooL tlie fact remains iliai 
AppleScript is not, BY DEFAllUf, enabled to work across a 
network. If a computer doesnl have filesharing turned on; there 
is no access. If progmm linking Ls not turned on. malicious 
scripts can’t run. If access is needed, then use proper passwords, 
with random characiers. Don't allow gtiesi access. Tliese are all 
simple things that we mast remcnilKT as the Mac OS enters the 
world of fCP/lF networking at a fester pace. 

Other conferences that were of use to netwtJrk admins 
inducleth Practic'al Introduction lo Mac Networking, Macintosh 
Network Administration with Apple Network Administrators 
'[■cK)lkit, and Implementing XML. In any event, I found, and 1 
think any netwxirk admin would have as well, the pre-show 
conlerences to he well wortli the extra expense. 


John Welch <iTiai]i!:>:jwelch®aeLCom> Ls the Mac and PC Aclministraroi^ for AER Inc., a weather and ainit aspheric science company in Oimimilge, Mass. 
He has over fifteen years of experience at making computers work. Ills S|X*cialties are figuring out ways io make the Mac do what nolxxly thinks it 
can, and showing ikit the Mac is tlie superior administnitive platform. 
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Keynote 

As with ;my Steve Jobs kcym>le, Linii< ipalion is the 
overriding e mo lion. This yciir was my first keynote that I was 
able to see live, thanks to the folks at MaeTech, 1 was 
actually inside the auditoriuin for the Keynote. As usiuih 
Steve started [>y sliowing the state of Apple attd the Mae. He 
thanked all of us, Uie eustoniers, and all of Apple's 
employees for making it [K>ssible. He then reviewed the 
various sales nunilTers. Again, these are very important for 
Mac IS/IT managers to know\ iinfoitnnalely, too mucti of our 
jobs are taken up by platform advocacy. So, when the "Macs 
must go” cry starts up, these sales nuinhcrs are critically 
important in getting the non-technically oriented cxmipany 
offic'ers to see that Apple is a growing part of the compiler 
market, and therefore, a safe company to spend company 
assets on. The basic numbers are very good, with Apple\s Qi 
the biggest in the company's history, almost 1.4 million Macs 
scjIcI. Various breakdowns of the numbers are available at a 
number of web siles, ant hiding Apple's. Again, the important 
thing is that Apple is now pushing product at volumes that 
are respectable regardless of which VViniel c'otiipany they are 
measured against, 

'I he new features of the Apple web site redesign are svell 
greeted by this writer, as now, ALL of Apple's support 
programs are easily located. I found programs I didn't know 
existed, and without the usual blind searches and trolling the 
siie map. (Mote to other companies: EASILY located 
main!eiKinee information is a good thing!) I also found the 
possibilities of iDisk, Apple's free 2t)Mb Inlernel accessible 
slorage area of interest. Not from an Internet point of view, 
but because by using ApideSharelP, (in this case, Xinet's Ka¬ 
sha re product), Apple is giving Mac users decent online 
storage that cIckcs not recjuire me to teach users FFl^ or any 
sucli caller silliness. A little ApfileSeript in Internet Explorer, 
and vKjla, a remote stcaage area is on your desktop. I can 
also see this as a tiice wAy of demonstrating that Apple, and 
AppleSharelP can indeed lu* a valuable pari of the Internet, 

Of exmrse, the biggest part of the keyntHc was the Mac 
OS X anntmncemem. Jobs gave a schedule of a third beta 
release at the end of January, a final lieta in the spring of 
2()(>(), In stores by summer, and pre-loaded by January 20t)l. 
Ait hough an aiiii>itioLis schedule, given Apple's aliility ttJ gel 
OS releases out cm time of late, I llilnk it is an achievalile 
schedule. Jobs also went over the basic siriuiure of OSX, 
which was interesting to me Idr a numlxT of reasons. By 
basing the lowest — level of the OS on Darwin. Apples 
o(>en-sc>urce effort, us well as BSD Unix, ihere are some wry 
neat pijssiliililies. One of the biggest headaches for network 
admins is the toil and grind of security, and the fact tliat much 
of our efforts are based on w orking around operating systems 
that are inherently insecure. However, Open BSD is a version 
of that Unix tliat has been reworked fre^m the kernel up to l>e 
the most secure OS in the world. By basing the UnLx levels of 
the OS on an open — source effort centered on BSD LInix, 
then the possibility of integrating OpenHSD's security fcratiires 


into Mac OS X looks Ixight indeed. In adclition to the security 
issues, having a BSD underpinning raisc\s the possibility of 
giving the Mac admin acc:e.ss to all the functionality of Unix's 
remote administration capabilities. However, mucli of this will 
defiend on Itow far up from the kernel things like Remote 
Shellj (rsh), Remote Login, (rlogin), and other tool.s will reach. 
There are equally valid arguments for keeping the reach short 
(security), and long (capability and cxmvenienc'e), m only 
lime will telL I will however encourage any admin wiio can, 
to join the developer program. This gives you, among other 
thing.s, advancre copies of the latest Mac OS, and a more dirc^ct 
line for bug reports. I5y giving yourself months to use a 
product, and affect it',s development, you can help ensure that 
your t rilical features stay in the product, and get a serious 
heads up on upgratle issues. 

The second layer of Mac OS X is the gntphics layer, 
made up of a 3-D ARL witich is OpenGL ant! a 2-0 API, 
currently known as Quart/, Quartz is similar io Display PDF, 
as it is based on Adobe's Portable Document Tor mat, (PDF). 
This allow.s Mac OS X to do .some fairly nifty things such as 
faster antialiasing, anti rotations. The better part of Quartz i.s 
(hat this is all available at the sy.stem level, .so any program 
(‘an lake advantage of these fealure.s w‘ilh much less work 
than is currently rec|uired. As well, by including PDF as a 
system — level gra[)hic‘s capability, that means that, 
hopefully, things like the display features of Adobe Type 
Manager et al will be a thing of the pa.sl. as ALL fonts In ALL 
aj^plicalions will be correc'lly rendered regardless of size or 
hmt type. The interesting 11 ting to me alKiul this is the status 
of TrueType fonts in the new OS. If PostStTipi fonts become 
as easy to use and display as TrtieType, and the OS is based 
around a PDF as its disfilay and text engine, then why do we 
nee<i True'l'ype at all? Sounds like ihe beginning of the end 
of the ""Which kind of font is this. Which kind of font do f 
need?" argument. I imagine tliat admins for the larger print 
houses and pre-press shops won't bv liroken hearted here. 

The inclusion of OpenGL at the .system level is again, 
allowing programs to rake greater advantage of 3-D 
capabiliries much easier tlian in the past. Although primarily 
considered a gaming technology, more and more programs 
are using 3'D fcjr genenc, mundane things, like text styling 
fnr pre.se mat ions, 3-D graphs of I'xcel spreadsheets, etc. 
Including a system-level 3-D API makes it easier for 
programs to u.se 3 l>. To render an object is now' a sysLCJtr 
call, instead of creating and deploying your own 3-D 
liliniries. writing your own APIs, etc. For the admin, this is 
much nicer l>ecause it means that less low-level third party 
libraries/extensions need io l>e installed, and troubleshot. 
Both of these become extremely useful in llie new^ User 
Interface .scheme fur Mac OS X, as we will see. 

The third layer of Mac OS X is the actual APIs the 
program.^ run under, being Classic, (current Mac OS 
applic^ations). Carbon, ('ported' Classic Apps that now mn 
almost natively, with access to all the new' fe-aturcs, without 
completely rewTiting the code, and run under Mac OS 9 with 
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the CarhunLih exteasitm.), iind Cucua, {eonipletely new apps, 
that will only run under Mac OS X). Apple is dtjin^ U'^s best to 
make the iiiigralion gentle, ami Without violating NDAs ami 
other agreements, they are doing it with as much grace as 1 
liave ever seen. For admins, this migration path is critiail, 
because if entical older applications can’t run, and custom — 
built applications have lo be coni[)letcly re-wriiren, corptyrate 
acceptance (jf this OS will be worse than nil 

Alihough Uie concept of Classic is nothing new, (Win- 
OS/2, t>r NT's own WOW. (Wnidows on Window's)), the 
inclusion of a ifansparenl environment, (seamless Win-QS/2), 
show'n Ml the 1999 Apple Worldwide nevelof>cr Conrerenee, 
(WWdX'l means that users w'on'i need to worry about whai 
type of application they arc rutin itig. 11iey double — cUvk on 
the icon, and the ()rogram runs. 'I'hat’s all the normal user cares 
aixyut in general, and that’s what A(>ple is trying to do. Do I, 
or anyone else really think that 100% of current appik'alkms 
will run under Classic? Hardly, but if Apple can keep 
c'ompatibiliiy with 90+ percent of w^hat’s out there now, 1 think 
they will have a lot of gmicful admins, yours truly included. 

Carbon is ilie in l>ctW'een step for Mac OS X, and it's for 
people who need to run on the current Mac OS and Mac OS 
X, and want to be as close to a native' program in both 
environments. Tins will probably be, intiially, the most 
coniiiKjn lyjK' of application for Mac OS X for at least a year 
or so, much like there were mostly Tat’ applications during 


the early years of the PowerPC changeover. The details of 
what Carlson docs, and how it works arc interesting, and have 
been gone over dozens of times in other articles, both in 
MacTech, and other publications, .so I won't go into the 
details here. The important thing is the spectl, and relative 
ease of making current code Carbon-Compliant. Apple has 
done an excellent job of this, as demoastrated at [he 1999 
WWDC, By providing tilings like the Carbon Dater, (which 
points out areas in which your cura’nl code is not Carbon 
Compliant), and providing ufsdaied SDKs for Carbon, Apple is 
giving the t'orpomte developer all the lools needed to take 
care of and shepherd in-house applications into the brave 
new world of Mac OS X. Before tliis is poo-pooed by .some 
saying that Microsoft did tlie same thing, understand that in a 
.sense, no they didn't. 'Hiere is an anakygue to both (J^trlxm 
and Cocxra, C a fx>or one, but tf you st|uim hard, you can see 
it) in Window's wiiii Win32 and Winl6. But in general, if your 
Wimlovvs 3-1 or DOS app didn't work under NT, you had to 
pretty mucli rewaiie it for Win32. There w‘as no middle 
ground such as Carbon, and it was sorely inisseLl (No, 
Win32s does NOT eount.) 

Finally, we have Cocoa, which supports the native Mac 
OS X APIs. One of tlie nicer tilings .Ap|)ie has done ff>r admias 
in multi-platform, and enterprise corporations is to make Java 
a native pbyer in this environjiient. This allows more 
companies to consolidate n-tter applications into a language 
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that is runnable^ on almost evef 7 thing. I'his also alUws 
companies to leverage Java expertise onio a plnrtbrm that has 
not been seriously considered as a 'serious^ platform for that 
language. All of tliis is good news for Mac admins being 
subjected lo the “You can't run Java w'ell on the Mac" line. 

Tlie final layer to Mac OS X is in a way the most 
important, the interface. AKA “Aqua’'^ it is the showcase for 
the new OS, and in the important ways, it succeeds. One of 
the l>etier user features is the integratitm of Sherlock into the 
Next file browser. Although Apple is calling it the Finder, it 
is a bold step, because it is in many ways a new GUI. 
Whether or not this is good, had or indiffereni, 1 leave up to 
you. 1 personally like it, but for what may seem to Ite odd 
reasons. {NO'l'E: for a goorl look at Aqua, check 
hltp://www.apple.cornymacosx/ ) For one, by applying 
movement to the default button in a dialog, it is much more 
instantly obvious that a [)articular button is special/delauIt. 
(Anyone whfi has ever hunted perfccily understand.s that 
motion can be seen LONG before color, texture, el al.) lliis 
is a boon for teaching new iLsers ahirut dialog !>oxes. 
Likewise, since Navigation S^ervices allows save dialog boxes 
to be hidden when the application is in the background, 
attaching the Save dialog to the window you are saving a 
document in is again, a nice loiic h to allt>w u.ser training U> 
accelerate, and help de.sk calls to le.ssen. (Tlie non-admins 
out there wimki be shocked to find out how' many of my 
u.ser support calls are based on basic OS features that really 
aren’t imuiltve as they may seem.) Also, since Mac OS X is a 
multi-user OS, the issue of who was tm a machine last gets a 
lot easier to handle. Finally by making it very^ easy to make 
icons am! displayed text very large, those of us supporting 
users wiili impaired vision can ensure that these folks can 
see what they are doing without special extensions, 
keystrokes, etc. 

All in all, I am quite enihusiasik for Miw OS X tn the 
enterprise as an admin. There is a lot to like about the OS, 
and if Apple can keep lo their release schedule, Christmas is 
coming early indeed. So now we have a new' OS, but what 
about vendors, especially the critical ones? Well, again, no 
disappointments. Apple announced that the top lOt) Mac OS 
developers have committed U> Mac OS X versions of their 
products, and the top 4 of those were trotted out on stage to 
comment. The folks from Adobe, Macromedia, Quark and 
Microsoft all seemed to be amazed by Aqua, (not surprising, 
as a reveler at the Apple party pointed out that until the 
keynote, only about 6 people in the entire company knew 
anything about the new look,) Adobe committed to having 
all of their applications at least Carbonized by the release of 
Mac OS X, as did Quark and Macromedia. Macromedia also 
pointed out that they were able to get Plash Carbonized by 
one engineer in one week. Microsoft managed to go one 
l)etter, by showing the Carbonized version of Internet 
Explorer 5, with a spiffy new Aqua-esque interface, and 
publicly committed to Carbonized versions of Outlook 
Express and the next version of Office as well. For the 


corporate admin, Microsoft's support cannot be 
underestimated, so a public showing of !E Carbon, and a 
public commiUneni lo a new version of Office on I he Mac OS 
and [he new' OS is a big deal. For the corp<irate customer, 
there was a lot more to like about the keynote than not. and 
1 am not loo upsel about no new’ hardware, as it means less 
email asking me wJicn .someone can get the new^esi toy. No 
new' FowTrBook announcement means I still have the fastest 
for a litile w'hile longer, and thaTs always nice U)f>. 

Show Floor and Prodikxs 

There were a lot of networking and administration 
products on the slum' floor. While I can’t go into them all 
here, I wall point out the ones that either have a history of 
making my job (and by extension, my litcO easier, or the 
sparklies that caught my eye. (When w'andering a show- floor, 
1 highly recommend a Myna bird attitude. Check out 
everything that catches your eye, and a few things that don't. 
You never know whnfs hiding behind the Apple area.) 

Of course, the long time admins friends were there, first 
among these Ixdng Netopia. I simf>Iy cannot say enough nice 
things al)out this company, in particular tlie netOaopus 
group. They honestly listen, and take seriously the concerns 
and needs of their customers. As a result, netOctopus and 
Timl)ukiu arc an indispensable ])an of my i<K>lbox. The 
netOcU>pus folks were showing off the new SNMP features of 
I heir product, which makes an already grjod application in the 
Windows/Mac admini.slration area, now start to extend into 
the overall cnlcrprise. Along the same lines, Neon software 
wMs shnwing off their LinSiirv^eyor pniduct, which uses tSNMl* 
and AppleTalk et al to construct logical maps of your network, 
and alen you la alarm condiikjns via email, etc The AG group 
w'as showing off EthcTpeek, which is nt>w being Imndled with 
net (Octopus to give you Ixnh liigh and low^-level 
lrt)ublcshooting capabi[itte.s for your network. Not to he 
ignored, Dantz liad a very^ impressive area for their backup 
products, now running on Windows as well a.s the Mac. 

In the utilities area, the golden child of Mac utilities, Alsoft 
was showing the latest update lo their DiskWarrior utility, 
ver-sion 2.0 Hiis update now has the ability to help prevent 
directory cx>rRiption on the Mac as well as repairing it better 
than anything else on the market. Symantec was showing off 
the late.st and greatest Norton Utilities and Norton AntiVirus for 
the Mac. Nor to l>e outdone, .MicroMat had a very well located 
bcKJth and was liyping I'ech’FcKj] Pro 3 fast and furious, Mac 
stalwart Daiaviz was dcmonsirating the latest versions t>f their 
file iranslarion utilities as was PWB. 

In general, for both product and quaritity^ the show^ HcKir 
was simply excellent. From FireWire networking to network 
management to asset management, every category of 
st>ltwarc that an admin might care about w^as well 
repre.sented. The Mac my he still thought of as a consumer 
platform, hut there are a lot of apps for the corporate admin, 
and of high enough quality to make the Mac an equal player 
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in ulmosi any siiiiaiicm. My only complaint would have to be 
organization. After four days of walking the show floor, and 
between both sides of the Moscone Center, 1 was tired. 
Although I understand the desire to get people to walk 
around as much as possible^ setting up a networking area, 
similar to Developer Central would he a real lielp to admins 
for allowing us Uy figure cjut how different products relate lo 
eaeh tjtlter Tiien again, considering my shameful exercise 
habits, the walking was probably needed. 

CONM'RENCES 

Tlie final jXiit of the show is of course, the eonferenccs. 
On both the pro and u.ser trat:ks, there were enough 
conferences to easily keep you busy all Expo long, and there 
w'cre a lot of good, solid, techie conferences that make an 
admin's day. Besides the conferences I was scheduled to speak 
at, (w^hich included one on Uie state of the Mac Manager, and 
one on AppleScripting your netw^ork), there were a lot of other 
conferences that were of good use Xo acimins including: 

• Macintosh Nemorking Update, Presenting the Facts 

• I'alking to IS about your Mac Installation 

• From AppleTalk to IP, 

• Multi-User Macintosh 

• Kerberizing Logins and Multi Platform File Services 

• Emerging Trends in Network Design 

• Thv. Mac: Manager - Where We Are 'Foday 

• On the Trail of Netwcjrk Problems 

• Mac to IVT 1 

• Comparing AppleShare IP with Windows N'l ik 
Windows 2000 Services 

• VPN, the Next Generation Remoie Access 

• Unique Aspeeis of Maeintosli Administrator 

• Frtxecting Your Network with Firewalls 

• DSL vs Dedicated Circuit 

• Rumble in the Jungle 

• Apple Events over the Internet 

• The State of Java on the Mac 

• Impfementing XML 

• The Darwin Report 

• The Status of Apple’s Open Source Initiative 

• Mac to NetWare Integration Techniques 

• I’he Seet>nd Coming of Broadband, Part Two 

• Software License Compliance - Mixing the New 
Licensing Paradigms with the Old 

• Mac OS Update, Myslerics of the System Folder Revealed 

• Advanced AppleScripting 

• Anywhere Connections with Apple Remote Access 

• Why Crashes Happen and What to Do about Them 

• Macinu>sh Telephony 

Regardless of whic h sessUms you attend, the point to 
remenilKT is that most of theses are not given by over- 


im porta ni indu.su^^ ‘experts*. They are given by men and 
wtmien in the field, who are sharing their expcrience.s and 
secrets with you and others. For exam[)lc liie VPN session 
was given by the VPN person from NASA JPi. I have found 
in the past that one or two good sessiems, and 2fJ minutes of 
conversation afterwards are worth months of searching 
through a never-ending llnw of computer magazines. When 
viewed that way, Macworld Expo is an unhelievabie time and 
money saver. When you add xo the fact that every 
conversation I have with these wonderful folks ends with "If 
you liave any questions, here’s my card, get a hold of me and 
well figure it out/, well, you literally can't pay for that kind 
of support network. 

After Hours ai Macworld 

While it may seem strange Lo recommend to admins that 
they go to a lot of die company parties and geMogethers, Pm 
doing just that. When you are on the show floor, you are 
competing for a vendor s or an engineer’s time with hundreds 
and thousands of people. At some of the after-hours events, 
you can corner a vendor, especially after a beer or two has 
relaxed them, and really talk to tlicin at length. I am 
continually amazed at die nuggets 1 pick up at these things 
that have direct bearing on my jol>. Fm not saying go in there 
like a hunter, these things are supposed to be FUN too. But 
understand that they can be a valuable source of intelligence 
I hat you aren’t getting anywhere else. And ifs amazing how 
someone who is no longer surrounded by imndreds of people 
screaming questions is willing to sit back and tell you almost 
anything you need to know. Again, a lot of this is helped by 
die fact that a lot of these people are just plain decent as heck. 
I'hey want you to use their prt)duci, they want you to be 
happy with it, and if they see you as John or Boh, instead of 
faceless support call # 32,987,561, ids even more astemndmg at 
how far they will go To help you out. If you want the listing 
of such events the only place to go is Hess Memorial 
Macworld Expo Events List, maintained by llene Hoffman, at 
<http://wvvw.xensei.com/users/ileneh/partylist.htmt>. 

CoNt:i.usioNs 

Regardless of what you specifi<aliy do ai any future 
Macworld, or did at this one, you will find, as I again did this 
year, that tlicy arc an invaluable re.source, unique in the industry' 
for the well-tuned in Mac Admin. This year has given me more 
resources and information on w'hal 1 need to do my job better 
dian 1 would have gotten in six months of classes. 'Ibe contacts, 
and honestly friends I have made through Macworld are 
continually excelling as the formerly secret source of tny 
Tibenech’ reputation in my office. I highly urge anyone in the IT 
field who cauldn*t make it to San Francisco to go to the New 
York Expo in July, you won’t regret it. Ki 
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TOOLS OF 
THE TRADE 


By William Porter, PofytrufK SoluUons, Houston. Texas 


FileMaker Pro 5 


Is better good enongb? 


LvrRODucnoiN 

FileiV1;ikt*r Pro 4*x, in 1997, 

was a wonderful pniiliui, my tavorite 
applicuion, packing a fair anioLnU of [K>wlt 
into a itx)l with the GUI known to man 
or geek. FileMaker Pro S, released in 
(XtolxM' 1999, is Ixiler than FileMaker Pro 
4. So a Jhnkiri l-ileMaker 5 must lx even 
more wtmderruf right? It depends. 

Imd-uwrs and whal I might oil {husv 
develt>[xr.s have alvvay.s Ixen FileMakers 
primary market, beciu.se tlie product lias 
had a winning comhination of power ami 
case of use. That tioes nol change In 
version anti these users, wiio vveie 
already pretty happy with FileMaker 4, will 
enjoy the enhaticements in version 5. 
Small-lime web pyblishers will llrid instant 
w'cb pui>iisliing with FileMaker 5 even 
cisier than Ixfore and a little more seciiar. 

On the other hand, professional 
developers, who have Ixvn hoping for 
years that FileMaker would one day 
release an upgrade lliai would take the 
[)rognmi to rhe nesi level the way the 
version 3 upgrade did, ar*e [xnmd ro !x 
ambivalent at best about version 5, Stane 
will lx tlownright disappointed. I'ilcMakcr 
S’s ^single iiKkSt interesting lea lure (K.Mh 
supjx)rt> is UK) much, too ,stM)n (and you 
will need the Developer Fdition to take 
advantage of it anyway). In oiher ways, 5's 
improvements seem like Uxi little, Ux> late. 


This review is addressed mainly to professional 
developers, those w'ho are develuiiing t>r hope to lx 
developing solutions, especially complex solutions, for 
paying clients. Please note dial the review' deals exclusively 
with the FileMaker Prt) 5 Standard Edition. MeiUier FileMaker 
Pro IJnlimiied (for web deployment) nor FileMaker Pro 
Developer Edition liave fxen released yet. But according to 
the advance information from FileMaker, Inc. (FMl), 
FileMaker Pro 5 Unlimited differs from the Siandard Ediiicm 
mainly in iliai it does nol count the number of IP addresses 
accessing the databases, (Unliiuiled's licease is also slightly 
diflereni and allows you to use it with lliird-]>arly CGTs like 
l;asso, but that is apparently not a technical difference.) And 
advance [lublicily about the Developer Edition indicates that 
ii w'ill not address any of the problems I discuss here, (In 
addition to giving developers the ability to build single-user 
runtime versions t)f tlteir soluiions^— uscbil mainly for demos 
— the Developer Edition mainly provides the APIs needed to 
develop plug-ins for FileMaker ITo S. But the copy of 
FileMaker Pro ^ that comes with FileMaker Pro Developer 
Edition is no different from the copy under review^ here — 
same development environment, same pliisses and minuses.) 

The Answeii To Developers’ Prayers? 
l*or many years, developers have complained tliai 
FileMakers development dialogs — in partiailar, Chose for 
defining fiekfs, relaiionsliips, cakii la lions, and .scripts — w ere too 
small. Every' tlevelopei' I know had luicked hi.s copy of FileMaker 
with ResFdii to make the di:ilog,s larger. So it was not .surprising 
that the audience al the FileMaker Developers Confeamce in San 
Diego last August eheeied enlliusiaslieally when it was pointed 
oiii with a flourish tliat the dialogs in lalcMaker n aie Imally 
resizable. FileMaker has Ixvn tistenrng to usl we thought. 

'llie cheers might Itave turned to groans had FMl also 
pointed otit that the dialogs do not slay resized. You have to 


William Porter b ihe owner ol Soluiiims, a llrni in Houston, Texas, specHalizing in nistom dilalxcsi.' anti Wd>- 

apfiliailitjas tlevelopment, A niemlxr of the XXII Group, an inUTuarional cons^mium of Web tievelopers, Will has jusi finished 
a projetl In l-ileiVlaker Pni ^ Ihat tracks news]>a|Xr circulation. He has recently become an AGl I IS Fanner and has added 41) 
lo his loot fhesL Yt)u can reach him i>y sending e-mail to wlll^polyimpe.com. 
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rcsixc than every lime ycm open them* I’ileMaker vvns listening, 
but with unly one ear. Admirtetily, rhi.s is a small thing* ilui il 
.SL'cms oddly lypica) id' the entire ujignide, so many aspect.s of 
which leave one wondering w^hy they didn't go the extra blcKk 
and a hall anti really tio it right. 

(Not much can i>c* done alxml llie cakulatioit-dehnition 
dialog* hut you am reduce the frustration of having to resisce the 
oiher dialogs every’ time you ojx^n them by creating a macn> in 
KeyQitencer or Quk Keys lo do il for you* Kvery time I t>[K'n a 
rcsUalde dialog now, 1 type conrrol-Z, and KeyQuencer ?.ooins 
it for me to full si/e,) 

OllJi'R Ll'ITUi Bussjings 

Theie are indeed some very satislactoiy' imprfH'emenr.s in 
FileMaker S. such as relational (or t’ondiEional) value lists. A 
relational value list is tuahing more dian a adationship that has 
l^een defined spt‘cillcaIly for use as a value list* (Since its a real 
relationship, you can m:ike use t>f ii in a portal ;ls well, but you 
prot>ably won’t*) Its mosi obvious use Ls to provide different 
options for diffeieni items, lor example, a flannel shirt might 
come in red and green and lour differeni size*s, while a fxiir of 
shi H.‘s migiu ciHiie in black and brown and Tilteen dilferenl sizes. 

The figuiv shows values in tlie ""ojition" held lliitt come 
from another lile. The relationship is based on a maiiii beiween 
product ID in the current file and priKluci ID in the ojxions hie. 
In the figure, the user is viewing tile options for the propeller 
cap product. The list of options shown here is pei'uliar lo ihe 


product “propeller cap." If you clicked on ihe record lor the 
Bach tee .shirt, the list would show the ojxUms “J.C.* j.S.. 1^D.Q. 
and W.F." dhesc values are drawn from recorcls in the Options 
file* IF you wanted to Itave more than one relational value list* 
yt^u would simply create more than one options file* (A dothing 
store migiu allow customers to .scdecf size mid color.) 


1 - : 

ID product nAma 
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28,5 

2 Rabbit SlippQfj 

Medium Fue;v 


13,72l 

JiL Prepeder Cep I 

Hetbanioal 
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figure f A re/aftaruif puluv list. 


1 have one complaint about this featua*. It Is hard to get 
these optioas to sort tlie way you would like. I wanted a .set of 
size opiions lo sort as S, M* 1. and XI*, but they always appeared 
in the list as L* M, S and XT. talphalretical order). Normal value 
lists c^an use a custom order* I'ninkly, I was surprised that the 
values did not liisplay in the order they wen: entered in the 
opiions file* Still it’s a nice feature. 

The most interesting change to MlecVlaker's CM in versk>n 5 
is the addilkin of a tabular display of data. In table view, all tlie 
fields displayed on ihc layout for a record are displayed in a 
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single row, akhoLigh you dont lose all of ihc text and numtKT 
formats assigned to fields. (In the screen shot below, notice the 
dollar-signs in the price and the bold product names.) 


pricf' pfoduct ID product n^am* optiun 


:pric^ 1 


. name 

- * . .. -.. CPtK>l» . 



1 ^ 

tee sKirt 

Oj.s iStd.o Ovr. 



2 

Rabbit Slippers 

Bald ^ Ejctra Fuzzy FuKy 


$2S.50 

2 
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CEa Id 1 Eytf* Fozry # FUHV 


$13.72 

3 

Propeller Cap 

OHselunictl O Solar Pa 


$32 49 

4 

Vi>rk Slacks 

O Cherry OFujchia OriiuY* # 0 rin 9 » 



iitS 


Figure Z FileMaker Fro .5's new table vieur 

The options for table view are set in die layout setup dialog. 
You can allow users to resize columas or even drag them 
around. In Liic figure, the user has just sorted the product ID 
field by clicking on it. 1 like tliis addition a lot, fjccause it has 
allowed me to create a layout that users can safely play witli, [f 
they want to create their own simple reports. 

This feature Ls not without its problems. If you are going 
to use tal>le view, you wall proliahly want to give your fields 
plain English names r^iiher than employ the .special field- 
naming conventions many devekspurs favor (“cn_statetax'' for a 
numeric calculation fiekl for example), since the column titles 
in table view display the real name.s of the fields and cannot 
be changed. Second, if you wi.sh to offer your u.ser a list view 
that you have designed and also a table view, you will 
probably want to create two different layouts and place a 
button on them that toggles the views back and forth. This is 
the only way to get column/fiekl titles to appear once and only 
once in each view^ In the figure above, note that the Held tides 
in bold are placed on the header part and continue to appear 
even though in table view, the columns are autoniatrcally titled. 
If you remove the field titles from the header part, the table 
view wilt look bemr — but when the user switches back lo 
normal list view, the fields will be without titles of any son. 
The only good solution is to use two layouts. 

Finally, when I created a table layout using my own column 
titles (because I didn't want users to resize columns), 1 
discovered something veiy odd: You can control die appearance 
of the table columns wdiile in Browse mode, but you cannot 
control die look of the columns in layoin mode. T had a lot of 
tiouble getting my column dtles (text objects placed on a header 
part) to align properly with die table columas. I liad to keep 
switcliing back and kmh betw'cen browse and layotit modes to 
see hoW’ things were lining up. 

An ''improvement" I find less useful, but which others will 
no doubt appreciate, is the addition of two toolbars, one for 
standard FileMaker commands like sort and find and omit, the 
other for text fornuittiiig. FileMaker 5 is making a play to replace 
Acce,ss as the preferred dauiba.se for Office users under 
Windows, and these toolbars have iieen designed to look as 
Microsofr-like as possible. 


IpBi::I ■ 

i: I \ l » ^ ^ l ^ • I 

Figure J. Ihe neu^ toolbars, 

Disi hut not least among the little blessings is the inclusion 
of a sjK^ial import routine for updating one file with data from 
a copy (e.g., updating a mtister contacts database stored on a file 
server from recent data stored in the contacts database on a 
PowerBook). You s|:x:eLfy one or more match fields, then define 
which of the otlier fields you want to ini(x>ii. 

FileMaker Pro 5 on the Web 

Perhaps it is because J am a Lasso developer tliat I am 
unimpressed by the improvements in FileMaker 5's web¬ 
publishing tools. Or perhaps it is because they are just not as 
good as they sound at first. 

'I'he bad news here is that, if you are using the Standard 
Edition to publish your data on a TCP/IP nemork (interner 
or intranet), the host copy of FileMaker will accept remote 
connections from no more than ten IP addresses during a 
“rolling twelve-hour period.” This is a fairly novel way of 
distinguishing products and I suppose it rellects the difficniliy 
of figuring out how to license web-application softw'are. With 
FileMaker Pro 4.x and the Web Companion, for about $200 
(street price), you could publish a database and users around 
the world could actually connect to it, view its data, create 
and edit records, and so on. Y"ou did not even have to buy a 
fill] web ser\'er such as WebSTAK. To do the same thing with 
FileMaker >, you'll need to spend five limes as much Lo gel 
FileMaker 5 Unlimited. This has caused a certain amount of 
complaining among users familiar with FileMaker 4, But 
tiiese changes in ihe pricing of Uie products seem reasonable 
to me. FMI was giving the goods away before. 

Nevertheless, ihe limitation in the Standard Edition is so 
severe that il is a lillle hard lo undersiaml wliy FMI bothered 
including any sort of web-capability w'ith the Standard 
Edition at all. Note that the resuiction refers to IP addresses, 
noi users. Unless your expectations are extremely low, this 
makes Standard Edition more or less useless as a Wel> 
publishing tool The Web is supposed to be all about 
connectivity, bui web publishing with FileMaker 5 Standard 
Edition has to be about discouraging connections. A single 
user with a dialup connection to his tSP might exceed the 
ten-IP limit all by himself if he disconnected ami connected 
repeatedly and received a different dynamic IP address each 
time he reconnected, 'fliis is not a far-fetched scenario if the 
ii.ser is, say, a travelling .salesman dialing into the home 
server to place orders, A single user bent on mischief ctjuld 
do the same thing on purpose and lock up a database. 
Standard Edirion^s web-publishing ability seems useful 
mainly on a dcparirnental intranet, where a small number of 
fellow workers w'lth fixed IP addresses will be able to access 
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a shared database usin^ tlieir browsers, thus eliminating the 
need to purchase extra copies of FileMaker. It Ls important to 
keep these liiiiiLalions in [iiind, since FMFs advertising 
emphasizes FileMaker S's weh-puhlishing capability. 

I he good news is that you get to publish your databases 
using your own layouts — more or less. In other words, you 
do not need to create web pages in I lome Page or GoLive to 
have a custom look to your pages, and you do not need to 
write any HTML. 

Once again, however, tlie reality is not quite as neat as the 
press release wOLild make you think. 

Fcjr one [hing, at the present lime, it does not work in 
Netscape at all (Apparently the trick of disi)laying database 
layouts on the web involves the use of some proprietaiy 
[Vlicrf>sc>ft CSSl tags.) .\nd my numerous experiments with it 
under lx)lh Windows 95 and the Mac OS lead me to etmclude 
that it does no\ work 1(X)% of the time even under Microsoft 
Internet Fxplorer 4.5 or higher. 

For another thing, your user will no! see your database’s 
layouts exactly. He will at best see your layouts sunounded by 
a standardized FileMaker 5 web-publishing frame, which 
pi-ovidcs the various command buttons the user neecLs to do 
anything with your database. Since there are only a handful of 
these frames built into FileMaker, databases published using 
Instant Web Ihiblishing are still all going to kx>k alike. (Tlic 
fiames are supposed to have been “professionally designed," bur 
even to iny amateur designer's eye they look pretty Inland.) 
Furthermore, we are talking look here, noi ftinciiiinaliiy. Hiiuons 
on your layout tliai are tied to scripts will appear on tlie web 
pages hut will not work. Only simple, not-script buttons such as 
a button that switches to another layout will work on the web 
page. This means that in tlie end, you will Ix^ creating S[>edal 
layouts for your web jijages anyway. 

It must also be noted that FileMaker Pro S'.s web security 
IS still weak. New in rhis version is tlie ability to specify that 
a file can be shared only with particular IP addresses. This is 
valuable. Of greater importance however is what is not new: 
the fact LliaL Web Companion action that you trigger in your 
browser causes a wealth of information about your database 
to be displayed in the browsers location or status areas — 
the name of your database, field names, layout names, and 
so on. This is what appeared in Inlernet FxpIorer’vS location 
field when 1 searched for the Bach tee shirt in the products 
database that 1 created for this review: 

htip:/yiOHO.IO.10 / FMRes/ FMP to7 dbd L citisS 

op=bw5tproduct^%3a%3yi]rcidiuct%ZOiiaine=bacli{- - iop=andSi 

- f orniat-iForTnVvCES * htmi ’ lay=ProdactI>etaiI& S 

- skip^O St-token. 0’^25& - token. - find 

I'his line reveals the name of the database (“line items”), 
the name of a relation Cproduces::") which one might 
rcasonairly guess liappens to use the name of yet another 
database, a field name (“product name”), and the name of a 
layout ("ProdnclDetaiF'). If you published your database 
using Lasso instead of the Web Companion, and if you used 


Lasso iniines instead of the old-fashioned Las.so lag .syntax, 
you could hide ihis information from the user conipleLely 
and permanently. It wouldn't even appear in the source code 
for your pages. 

It is clear that FileMaker, Inc., .sees the Web as FileMaker’s 
future. 1 can't say tliat it is FileMaker's present, however. If you 
are getting married and you w'ant to create your own online 
gift registf)^ and host it on the iMac: in your apartment, 
FileMaker Fro 5 Standard Edition would do tlie job splendidly 
— unless you have a lot of friends and relatives. For anything 
much more sophisticated than that, you are going to be 
looking cLsewhere. If you want your web pages to look 
[>rofessic)nal, youTe going to liave to get a professional page- 
design tool like Dreamw^^aver or GoLive and do the job right. 
If traffic on the site will exceed 10 IPs in 12 liours, you’ll need 
to spend the grand for the Unlimited Editioa And if the site 
experiences even nicKienitely heavy hits, you wall wain I to 
employ middleware such as Lasso or Tango to take the burden 
off FilcMakcT, who,se perfunuanee as a web application server 
does not appear to he improved in version 5. Neither the 
Standard Edition nor the Hnlimited Edition is multillireaded, 
meaning that by itself, FileMaker 5 is m> more capable of 
handling moderate to heavy traffic than I'ileMaker 4 w^as. 
(Apparently FileMaker 5 supports load-balancing, hut that's 
been possible for a w4iilc wiili other CGIs.) 
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Lisily, I wiiot to mention FilejMiiker Pro 5's support for 
XML, XML (^extensible Markup Language”) is a cousin of 
HTML, “HTML done right," as one authority pins it. XML has 
a great nuniber of uses, but it is attracting more and more 
attention as a way to share and format data on the Web. 
When the dust seules, this could turn out to he the most 
importani dimension of FileMakei 5- Unfortunately, at the 
present time it is hard to say mtieh aliout this, partly because 
the docainientaiion for FileMaker Pro i s XMl. suppon has nor 
been released (it will come with the Developer Edition) and 
partly because at the present time, only Microsoft Internet 
Explorer 5 for Windows supports XMr, ai all. 

Playing Nice with the Other Applications 

Umited, one-way ODtC capability appeared lirsi In 
FileMaker 4d, wliicii eould query data sources sueli a,s Access 
databases and Excel spread.sheets anti impoii data back from 
ihem, hut could not add records to a remote data source, 
FileMaker Pro 5's ODlKi support is largely limited to ODHC" 
level 1, but is now two-W'ay. FileMaker Pro i now supports the 
SELECi; INSHR'i; fPDATH and DELKTF SQL slatements. It does 
not suppiirt I he staEcments For creating tables and indexes, or 
dropping tables and indexes. This means that FileMaker Pro 5 
can interact with other data sottrees in an enterprise, but is not 
going to be a major player. 

On the other hand. Level I supt>on is adequate for 
laleMaker to play a very useful role on the end user's own 
machine, or within a workgroup — FileMaker, Inc.’s, target 
market. Microsoft Excel ha,s very good ODBCVSQL su|>[K>it, 
and I'M I hopes that Windows Li,sers w ill tncreasingly think 
using Excel with FileMaker rather than Access. 

lE is a lit lie irkkier Ehan FileMaker, Inc., would have you 
believe to eonfigure your computer to lake advantage of 
FileMaker's (.)DBC capability, 'file ODBC drivers you need 
are installed with FileMaker, bin on a Mac, you si ill neetl Lo 
configure the ODBC Setup eoiilrol |>anel, and tins piece of 
software lias to be the most opaque item in the Mac (J!>. 'Hie 
average user will wonder whai ilie tlifference between a User 
DSN and a File DSN is, which he needs to iastall, what a 
"data source” is exactly, and so on. Tlie coniroi panel's help 
is, well, noi very helpful. Funherniore, if you warn lo cTeate 
queries in Excel (iiiifiorting data into Excel from FileMaker), 
you will also need to have Microsoft Query installed, and if 
you want lo get data out of Excel, you will need to install an 
ODBC driver for it as well. These are not pan of tlie standard 
Mtcro.soft Office 9B installation, When I first .started to play 
with FileMaker is ODBC capability, I discovered that I did 
ut>l have Query in.stalled and I had to liuni around for the 
Office 9H muster disk to find and install it. 



figure 4. Ifonfy the ODBC Setup control pane! ufere 
as easy to use as FileMaker/ 

Bur once you have everything configured properly, you 
can indeed pull data from FileMaker into Excel with relative 
ease. Microsoft Query ta helper application that is opened 
automatically l^y Excel) allows you lo create an SQL query' 
three ways. There is a wizard that will w'ulk you through tlie 
process, although this only works well if your queiy is 
Hinited to a single data source. Alternatively, you can go 
directly lo Microsoft (^ueiy and look at I he data table.s, cTeate 
joins and define the columns (fields) you want, specify 
filtering criteria (price > $20), and preview^ the data before 
actually finalizing the queryc The third option Is to define the 
t|uery directly in the SQL slalemeni editor. Here, for example, 
is a query that find.s data in the lineliems and products 
databases and displays a lists of products with prices and the 
opi ion.s .selecterl by I he cusioiult; 

SELECT I inoricms.produclTn. product3.]>ro<iuctN.ime, 
lifjel Lenii;. optioii, liiiyl Lt’iiis^cosl 
t’ROH litit*items lirieiteM. products producos 
WHERE linelteins . productID = products . productlD 

Once you have defined the query, you simply move the 
data into Ex(‘el, ihcn mas.sage ii funher in any way you like, 
chait it, move it into Word, anul so oi’i. 

With its ODBC capability and its solid support For 
AppleSta ipi (and now AdiveX on Windows ), FileMaker Pro 5 is 
definitely a team player on the deskto[). Tills i.s a much more 
truly useful feature t>f FileMaker i than tlie improvements to the 
Wct> (x)mpanion. Ail of my clients use Fxcef and they find 
FileMaker [*ro 5’s al)iiily to share data witli Excel u development 
that enhances the value of the scjlution I built for them. 

Is FileMaker Pro a Developer's Tool? 

For years, clever users have pushed FileMaker to the 
limits and beyond — with an arsenal of parlor tricks — and 
gotten nu^re from the application than anybody has a right to 
expect. Four, five, six years ago, when FileMaker’s current 
reputation was being built, the DBMSe.s it was competing 
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wiili were mueh more expensive, had longer development 
eyeles, and often had much more power than the market 
demanded from a small datahase at the lime. Starting at least 
with version 2.1, a small hui signifieant number of 
develoi)ers found FifeMakcr a very viable alter native to tlie 
higher-powered alternatives^ for certain kinds of solutions 
that were commonly needed in business. The fact that 
FileMaker ever gut any restJcci as a developers tool is due 
less to its built-in capabilities and more to the brilliance of 
these earlier developers. 

lUit il is mn a f>rofcssional develof>er’s tool It has never 
really been. AncI now' that FileMaker S has been released, I 
am pretty sure it will never be. This is not necessarily a 
knock against llic product. While companies like ACl tJS 
tmaker of 4D) market exclusively to professional developers, 
FMl is content to market almo.st exclusively to end u.sers. 
Clearly FMl believes that iFs produtt does what the majtjriLy 
of its customers want it to do. Of course, those of us who are 
in the minority — the developers — have the right to decide 
for ourselves. 

The prices for all the FileMaker Pro 5 products are 
higher than the prices of the version 4 coiinterpans. And in 
the last couple years, competitors like Access and 4D had 
gotten easier to use, while remaining more powerful in most 
respects than FileMaker, FileMaker today i.s neither cheaper 
nor significamly easier to use ihan some of I he much higher- 
powered alternatives. When 1 talk about '"ease of use” here, 
1 m not talking about how quickly somehody with no training 
whatsoever tan install the program and Imlld an invoic ing 
application. 1 mean, ease of use for developers, not the end 
user — ease of use for people w'ho have taken a little time 
to learn how to use their owm roofs. It is a fault of much 
lliinking in the FileMaker community to fail to distinguish 
' between what is easy for the end user and what is easy for 
the professional developer. 

In fact, fcjr the develo^x.T — especially tlie independent 
developer who lias the freedom to decide for himself what 
tools to clioose — FileMaker is actually in many respects 
harder io use llian the alternatives. Ironically, one new feature 
of FileMaker l^ro ^ that I have not mentioned yet reveals clearly 
FileMakers w'eaknes.s in this respect. In FileMaker Pro 5, you 
can finally imp^irt scripLs from one file to another. The feature 
works quite well. You select the file from which you want to 
import scripts, then select the scripts. 


import Senpts 


S^sripts h: ill's &CMt!sr.2* 



Figuj^ 5- The selected scripts uhotii to he copicYl (imixmed) 
from the file WilLs B(X)ks.2** into the current J tie. 


If the script docs not reciuire adjusirnent, it will import 
without any problem at all. For example, say you have a bunch 
ol' Files in a solution, and you would like to implement context- 
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Mcaskive helj) in every one of llieiiL You could write a serij)! in 
one Tile that looks like this: 

If [status (currentHiod ifierkeys) “ ej 
fjf the user has held devn the option key 
Beep 

Show Message f‘"Shows context - sensitive help for this file"l 
K1 se 

# puL this file’s naroe in a global field iti llelp.FPS 

Sei Field [“help: :globai_arigiriatirig_file" , 
status(currentfilename)J 

# look up help articles based on the current filename 
Perform script [External: “Help::Get File Help"] 
f switch to Help.PPB to view articles found 
Open f'’Help.FP5“l 
End If 

You could then imporl this scripL into every oilier file 
(module) in your Boludon, and since it does not reference 
anything specific inside the (lie where it resicles, it will need no 
adjusLincnLs. (All of the files will need to iiave a slatic 
relationship defined to the Help.FP^ file. ) On the other hand, if 
you do import a script that does not fit perfectly into its new 
context — a field is missing, for example — FileMaker 5 will 
warn you so you can fix tlie problems immediately. Very nice* 



Warning; Errors were detectedi (turing script 
import*Veri^ alt script references in the imported 
script before running the script. 


[ 0 *^ 1 


Figure 6. FileMaker lets you know if an imfxjrkxLs'cript 
requires acijmlmenls such as changes to field names. 


But why is it necessary to have this feature ai all? It is 
necessary because of whai is perhaps FileMaker's most 
annoying weakness as a developiiienl tool: The fact lliat the 
data tables are inseparable from the prograniming rind laytmt 
elements. In every other serious DBMS, data is stored in 
tables in raw’ form, layouts and scripts are stored in a single 
application file (or a bundle of fhe.se files that behave in a 
more or less unified way), Then you don't need to copy the 
same code from table to table. The tables, after all, have no 
code attached to them at all. 

Once upon a lime — a long time ago, in a land far away 
“ the decision to join the layouts and the data tables made 
sense, l>ecau.se it made things very simple for the end user. But 
it lias not made sense to continue using this mcxiel since version 
3t when FUeMaker became relational four years ago. FileMaker’s 
unique behavior in this regard has a number of consequences, 
and n(>t a single one of them is desirable from the profes-sional 
developer’s point of view. I will list only a lew. 

Managing passmtrds and group access is a nightmare. A 
solution 1 recently complered uses a dozen data tables, that 
is, a dozen different FileMaker files (or ''databases,” in 
FileMaker’s idiosyncratic terminology). There are twenty 
different pas.swords in this system, and the passwords are 
tied to h>ur different groups of users, each of which has a 


different level of access. In order to enter tlicse passwords 
and create the groups, 1 had to open every single file, type 
all the passwords in again and again (each time selecting the 
access options for the password), then define tlic groups 
again and again in every file, then assign the levels of access 
to the groups. This is not just a problem for the developer. 
Obviously, this kind of ha.ssle discourages administrators 
from changing the passwords for complex systems regularly. 
(An “import passwords and groups’’ feature, similar to the 
new’ “imporl scripls" command, would minimize this hassle 
for the developer. But it w^ouldnh help the systems 
administrator who wants to change passw'ords.) 

Achieving a consislenl CiJIf throughout your sohilkm can 
involve hotm and hours of drudge work. FileMaker really 
punishes the developer who tries to give his solution a 
consistent look throughout. Say you have a solution that has 
ten files and a total of sixty or seventy layouts. You will find 
yourself pasting the same buttons into .sixty or seventy 
layouts, rewTiting the scripts in every' file. Heaven help you 
if yi>u cliarigc your mind later! 

>Pn cannot hide the data sinicture cw mil from the ettd- 
user After all, the user inevitably sees the files, with their names 
in tile title bar of evciy wind<jw\ In many of my solutions, this 
ends up confusing the user, especially at first. If I do niy job 
right, there is no rea.son for my users ever to have to think about 
how many tables (file.s) my solution uses. 

Providing updates is tricky. When a 4D developer gives 
an upLiate to a client, he siinj^ly instructs the client to throw 
away the old copy of the application and replace it wiih the 
new’ copy. The data Files are separate frcjiii the application in 
the same way that your Word documents are separate from 
Word. But updiiiing a complicated FileMaker Pro solution is 
a tricky — and ri.sky — business. You can .script tfic actual 
import to some extent, but the need to import the old data 
fn)m ilie old files into the new file,s means that you have to 
give the user careful instructions on how^ to place tlic new 
folder next to the old folder, rename the old folder {so he 
doe.sn’t get confused), and so on. 

There are other problems with FileMaker, unrelated to tlie 
linking of layouts to data. 

For example, FileMaker does not allow you to trigger a 
script or action when a user Labs out of a field after inputting 
data. This is souiethitig 1 mis.s every single day. {There is a third- 
patty extension that does this, but this should absolutely be built 
into the prognmu) 

In one critical area — data modeling — FileMaker’s 
peculiar approach is a liability to end-user and developer. If 
the average end-user tries to define in Hxce! a query directed 
at two FileMaker tables at once, he is going to find himself 
in unfamiliar territory, scratching his head at references in 
Excel to inner and outer joins. Here is what Microsoft Query 
display.s to tlie user w’ho succeeds in defining a tjuery iia.sed 
on an inner join: 
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3 Query l from FileMaker Pro 5 I H E 


—- 


1 uroductName I 

bptiim 1 Cost 



1 

Bach iee shirt 

P.D.Q. 14.95 



2 

Rabbit Slippers 

Extra Fuzzy 2® .5 



3 

Pr ape Iter Cap 

Hechanical 13.72 


A 

4 

Vork Slacks 

Orange 32.49 


H 

P 

Rabbit Slippers 

Medium Fuzzy 26.5 


6 

Beveraae 

5-5 


r___j 

|HM iRecord k 

imnMTZz" 



Figure Z A pin cleaned graphically in Micnmft Query. 


products 

* 

price 
productID 
productName 


ilnettems 

n 

cost 
option 
product ID 
totalcost 


Although this Ix^ars a rcscmijiance u> Figure 2, they are 
acPially quite different. Figure 2 shows the view froiii the 
perspective of the tineifems hie. But, Figure 7 has no such one¬ 
sided pcrspcaivc. The Lal>le it displays belongs neither to 
lineltems nor products. 

Tins is, in fact, a perfectly conventional representation of 
the data. In standard relational theory, a join is actually a 
tertium quid, a new table created when two other tallies 
intersect on a key fielcL 

Blit FileMaker u^sers do not think this w'ay. The average 
FileMaker user sees relationships as having a diaxtion (in FileMaker, 
yf>u am relate A to B, without leLiting B to A), and this leads tlieni 
to tliitik of R.‘Iati(mality as a way for one file to bomow' and dLspkiy 
anotlier's data. It is quite ironic tliat FileMaker Pro, which lias such 
a grKti graphiol user-interface, uses non-gniphieal dialogs for 
CR*aling reliiUonships, lxx:au,se this txmfiLsion could be eliminated it' 
FileMaker did it ilie way Access, 4D, ;ind even Excel do it, lising an 
iajnic icxil like die one show in Figure 7. 



Figure S. Ihe non-konic dialog you use to 
craalc a relalionship in FileMaker. 
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Even worse, FileMaker allows you to create diiplicare 
relationships, that is, to relate two files more than tmee using 
the same key fields. The grapliical method of creating 
relationships used by 4D and Access makes this impossible. 
Four years ago, when 1 reviewed FileMaker 3, I thought it the 
most brilliant upgrade 1 had ever seen, because the product 
had metamorphosed into an essentially different thing — had 
gone from fiat-file to relational — with almost no change 
whatever to the GUI. 1 now see that the metamorphosis was 
more superficial than I realized, A more profound 
transformation would have necessitated some profound 
changes to the inlerhtc.e. 

Perhaps worst of all, because of the inadequate way in 
which relationships are modeled in FileMaker — because 
relationality in FileMaker is just a matter of one taljle 
liorrowing data from another — FileMaker relationships are 
“shallow,” that is, they don't go beyond the two files that are 
directly related. 

Say you are creating a system tiiat tracks students and 
classes. This is a classic many-to-many relationship. Every 
saident can take many classes, and every class ermtaias many 
students. In every DBMS, a many-lo-many relationship 
between these two entities requires a join file. In I'ileMaker, 
this is not just a table repre.senting the logical intersection of 
STUDENTS and CLASSES, but a full-scale daiafjasc file, in 
which each record represents one student taking one class* 
Figure 9 shows how I would model the data for FileMaker 
Pro. Note that the join file must contain calculation fields dial 
capture llie data from the related file. If it were not for these 
calculation fields, the CLASSES file would not Ik* able to 
display student information (other than IDs) and vic:e versa* 
Double-headed arrows indicate a double or two-way 
relalionship, something that only makes sense in FileMaker 
terms: JOIN is related to CLASSES and CI.ASSES is related to 
JOIN* It\s not a conventional ER diagram, but convcntkrnal 
ER diagrams don't quite make sense in FileMaker Pro. 


STIKJOVTS 


JOIN 


CLASSES 


StuddnrlD* 

StudentName 

SSN 

Address, otc. 




ClassID ^ 
^ StudentlO 


Cate fleJids ti^ed to 
e*iprtire^ rtdar&i dsro 

StadtrfttNmTJO 

( ss/v \ 

■ * Address cfe. -- 
CtJSsNomo 

hstructof y 

Dcpartm&JL etc — ' 


K 


ClassName 
tfistructor 
Departmcrit, etc. 


figure 9. Modeiing a studimts/clmses 
JaiaixLSc in FiieAfakfr Pn> 


In 4D, the m^xlel is much simpler The join file, for 
example, contains only the two fields needed to define the 
join, the two ID fields. In 4D, it is not necessary to “capture” 
the data in the join File, because the join file is not a 
container at all, it is just a logical link. And tx?st of all, 
relationships is 4D have a long reach. If table A is related to 
fable B, B is related C, and C is related to D, it's possible 
to connect data in A more or less directly to data in D, by 
following the thread of relationships. The duplication 
involved in long-range relationships in FileMaker runs 
contrary to tlie whole point of relational databases* 

I could go on. 

Note that 1 do not direct my ct>rnplaints at the 
ScriptMaker or FileMaker's lack of variables. These are 
superficial weaknesses. The Script Maker is actually 
amazingly powcTfuL 1 would have been very grateful if 
FileMaker Pro 5 had made it possible to select multiple script 
lines and copy or cut them and paste them elsewhere. But 
the ScriptMaker is not the problem with FileMaker Likewise, 
I do not mention FileMaker's still fairly immature support for 
ODBC, although this is a much more serious weakness in an 
enterprise environment, 

1 understand that rewriting the program is a major 
underiakiog. Actually, with version 5, FileMaker Pro has 
gotten rid of the last bits of legacy Pascal code. The fact ihai, 
during the rewriting proce.s.s, .so little thought was given to 
redesign suggests prcaiy clearly that FileMaker thinks the 
i)raduLt does exactly what it needs to do, to serve the 
audience that FMl aires about* ft is now' c|uile clear Uiat 
professional developers arc not pan of Lliat audience. 

CONOltSlON 

For end ttsens, FileMaker F*rf) 5 lake’s a product lliat already 
scTved them excc^Jtionally well and makes it even Ix^tter. If' you are 
iit tltui titrgei group, tlien by all mains, upgratfe ami enjoy* On die 
odier hand, if ytni am one of the many tlevelopc'm who liave Ixjen 
dLssalisfic-d with FileMaker *s limitaiioiis, tlien tills might lie the right 
tiiiK^ to rake a lcx>k at die altenruitives. 


Resoukces 

For a little more information on moving data from 
FileMaker into Excel, lake a look at Andy Ksasinki's article 
on the suhjecL in the January 2()C)0 issue of FileMaker Fro 
Admor, If you are new to SQL, there are lots of hooks on 
the subject. Mo.si of them make it seem complicated, which 
it is not. Ben Porta's SAMS Teach Yourself SQL in 10 Minutes 
(SAMS Publishing, 2000) is easy to follow' and will have you 
creating sophisticated SQL queries in Excel in no time* The 
authority I quoted as saying XML is HTML “done right” is 
Simon St. Iiiurenl, and the lxK>k is XML A Primer^ 2nd 
Edition: M ik T Books, 1999. I recommend it highly lo 
everyone interested in the future of dalaba,ses on the web. 

m 
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The State of the World in Cryptography 


iNTRODllcnON 

Unlike most technologies, cryiMography 
Ls intimately connected to politics, social 
policy, and law. Iliese concerns complicate 
tlie job of someone working with ilie 
technology, and arc often frusmuittg to have 
to ifitnk lihmL 'fhb article discusses recent 
developiiienLs in the technology of 
ciyptogiaphy along w'iiti developmcnis in 
the nc^n-technical areas. 

In tills article, T will also assume that 
you are familiar wjtli some of the issues 
surrounding ilie current stale of affairs. If 
you are unfamiliar with the technology 
and politics, here are some iKxiks that will 
hel)') you get up to speed: 

• “Privacy on the Line,'* by Whitfield 

Diffie and Su&tn Eva LancLiu. MfT 
Press; ISBN: 0^262-04167-7, 

• “Applied Cryptogniphy: Protocols, 
Algorithms, and Source Oxie in C,” by 
Bnice Schneier, John Wiley ik Sorts; 
ISBN: (M7M 2845-7, 

• ‘ILindhook of Applied Crypiograpliy,'* 
by Alfred J.Menezes, Paul C. van 
Oorschol, and Scon Vanstone, CRC 
Pre.ss; ISBN: 0^493-8523-7. 


Tilt Social Landscape 

Glyptography texlay Is a hcH-butlon Issue 
politk:ally, and fora number of gcxxl neasoas. 
First of all, cryptography Ls a new tet:hnok)gy. 
lliLs may sound like a IxJd statentenL After 
all, historians of cryptography have }X)inted 
out tlrat every time a arltiine tea fas writing, it 
learas secret writing quickly after, and that Ls 
what tTyptography Is, the art d* secret 
writing. However, In the last century, 


piirticulariy in the List lialf-century and even moie so in tlie last 
(juaner-tentury, the art has been completely reshaped. 

Any mechanism for secret writing that existed before 1900 is 
easily broken today by anyone with a mind to. Tlie stiflware you 
need to break ir is easily available on the Internet. It may not l?e 
pretty, liuL iPs titere. By the end of WWll, the knowledge to do 
this was available to the major Allied govemmenLs, today iPs on 
the web. But even the jewels govermnents had at the end of the 
war are nt)w easily broken by software you can find on the 
Internet. We don't need Alan l\iring to break Enigma now; we 
have the machines he helped create, The tools for both creating 
and det'cKiing secret mes.sages are now out in the world to 
anyone who can do a Mule math. 

This is why it is a new ieclinolt>gy, and it Is also why 
governments are afraid of it. 'l1ii,s is to be expected; hcjw can you 
blame tfiem? If you had lieen studying ciyptography for 
hundreds of years (which the British and the Vatican did), 
everything you knew^ wa,s wtjrthle,s.s by 1950. Every tiling you 
learnetl betw^een 1950 and 1975 is worthless now, and only a few 
of the tilings you learned since 1975 are of value today, and it’s 
all because of tlmse computers. 

Worse, the new leciinobgies are in the hands of everyday 
people, and lliis is scary because bad people will use 
cryptography to aid their badness (as they've always done). 
The fact that this can't be changed (the horse is out of the 
barn), that honest peofile need cryptography to protect 
themselves (the legitimate uses oulweigfi the threat) doesn't 
make it any less scary for government. 

At least, though, they are starting to come to terms with 
this. While the US government policy is changing slowly, US 
officials are admitting that the policy is out of touch witli 
reality. Ira Maginzlner said as much in late 1998, shortly 
before leaving die Clinton atlminisiraiion. (See 
<http://www.latimes.eom/HOME/NEWS/P0LITICS/ELECT98/NATELECTW/ 
tCB00a1487.html>) ' 

In contrast, the French government startled everyone in early 
1999 by completely changing iLs jxilicies. They iinmediaiely 
kxisened restrictions on 128-hit cryptography, and started the 
legislative pnxess to completely deregulate cryptography. As I 
write this, rumor i.s that those new laws will l)e done by die time 
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you ijro reading this arriele. In laci, the June Ls.sue of ‘\Nef 
imigazine contained a CD with 50 MB of ent:ryplion progmnxs 
including PGl^ and was sold over the counter in France. 

On ilie other hand, in late 199H, liie US government lol)i>icd 
die Wassenanr Armngenient countrit.*s to cbinge tlie Wassenaar 
exemption for so-called “mass-markei" software containing 
c'lyptograi^hy, 'Uie Wasvsenaar Arrangement is an agreemeni 
Ixrtween diiity-tliree aiuntries alx>ut exfKJiting ‘"dual-use" items. 
DuaUuse items are iteiixs that have Ixxh c ivifran and iniliiary uses. 
Cryptography is a dual-use item, as are ]>lutonium, and 
su[X*rcornpLiters. One sfitjuld l>e aware^ though, ilua a PowerPC 
Gi ora Pentium II is considered a supt^rcomputer. To hear the US 
government announcement on ilie t.hange, one would tliink thai 
all tluriy-three countrtt^ had agreed to US governmeni review' of 
all software. This Lsn t Really what hap]X?ned, iliouglr To staii 
with, hem is a quote from the Wassenaar Arrangement itself: 

“The decision io immfer or deny h^am/er of any Hem tvHi 
he the sole responsthHity of each Parikipating State. All 
measures undertaken with respect to the atrangemeni will he 
in accordance with nadonttf legiskdtion and poikies and Ufill 
he impiemenied on the Ixtsis of national discretiort" 

Read that carefully. Note tliat it says that (I) each counliy 
gets to make its own decisioas, (2) a cf>unLry’s own law^s take 
prt:t:edent over the armngement, and (3) if a country decides not 
to implement a pan of the arrangement, ihai's okay, 
lairtliermore, if a country Iras an export conlrt)! jx>licy that dotxs 
nothing more than require a one-time form to Ix^ filled out, then 
liiey are fully in compliance with the arrangement. 

If you have lx;en foMow^ing the news and hrouhaha alx>ut 
the Wassenaar changes, you may want to f>ick your jaw up from 
tlie tal)le now. Wassenaar is noi a treaty, it's just an agreement 
among nations, and as part of the agreemeni, iheyVe allowed to 
agree to disagree. Tlie US governmeni announcement (available 
at <http://vwwvJyaxom/wa-statel298.htm>) was disingenuous at 
lx‘St, and pure propaganda lies at worst. Ilie danger from the 
Wassenaar changes is not die agrtxmieni iLself, l>ut tliat the 
agreement provides an excuse for restrictive laws that w'ould not 
have otherwise Ixen passed. Fortunaiely, the t hange in France 
has put this all in its proper perspective. 

To sum up the changes in liie social land.scape, I want to 
note that the goal of people who want free ust* of t ry'ptograpliy 
is realty nothing more than our wanting our govemnient to obey 
its own laws. We want to protect our dexuments and messages 
as they travel over the network. There is no explicit 
Constitutional right to put a letter in an envekipe. Ixit none of 
u.s would tliink we need one. Similarly, surveillance is allowed 
only in extraordinary circunisUinces {that's what a court order is 
- an extraordinary ciRumstance) by law^ enforcement. It is even 
restricted when [X’opie record themselves. In Virginia, for 
example, only one party of a conversation must consemt to 
having the conversation taped, but in Maryland all parties must 
agree. This is what made the Tripp-lew insky ta^x^sso intere.sting 


- Linda 'I'rtpp was iti Maiyland when she recorded Lewinsky, 
who WAS in Virginia, Note that in neillicr .state would third-party 
tafiing lx legal. On the Internet, cryfXography is the only ttxil 
that law-abiding people can use lo enforce ilieir legal protection 
agaiasi Ixnng Rcorded by thind partitas. It is good to remember 
that it ckx^snT matter what stRngtli cryptography you use lu talk 
to someone who is recording you. 

GtlWKNMENT iNnUnVES 

I'liere have been a numlx^r of interesting iniiiative.s by 
govern menis. As I nientioned alxwe, the Irench government has 
completely changed its stand on ilie use of strong cryptography. 

Till: SAFE Bill Rides A(i.AiN 

In the United States, Congress is sk>w ly moving forward on 
a law to lilx^ralize the use t)f strong ciyptogniphy. Tlie SAFF. bill 
has lx*en inirtxlaced again, and is progiessing through Congress. 
In wiiaL rc[)resenis the claw' marks in ilie ground being tlragged 
I Kick a few more feet, the Commerce Department has lil>eralized 
the export regulations a little. The new regulations jx^rmil eX]X>rf 
to most coqMirations, and adtliiional RJief for the financial and 
liealth care industries, None of iliese, tliougli, pennii someone to 
put on a w^eb page infoniiation that would lx: legal to prim on 
paper. It mmains to be seem how far ilie SAFE bill will get this 
lime. The curreni status of tlie bill can lx: found at 
<http://thoiinasJoc.gov/ by checking on HR 850>. 
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Till- Advaimc j-f) liNttRYpnoN Standari:) 

However, the US governiiicnl is sponsoring a whole new 
generation of cTyptographic algorithms as part of its new^ 
Advanced Encryption Standard, or AES. Tlie AES is a 
replacement for DHS, which lias iieen in use for two decade's. 

The AES is interesting both technically and politically. 
The AES will l>e a cipher that has 12H-bit (16 byte) blocks, 
and can be u.sed with 128, 192, and 256-btt keys. This is an 
interesting step forward, up to the AES ret]turements, most 
cipher design was for 64-bii blocks, and 128-bit keys. There 
have been a number of variable-length key designs, hut liuJe 
emphasis on demon.strating that a key longer than 128 bits 
actually got its user any more security. 

Consequently, the AES has ptjshed cipher design into a 
new dimension. The larger bl<x:k sizes are importam, 
because there are altac'ks on using a cipher for a num!>er of 
blocks that are more than the ,s<piare root of the block size. 
Thus, a ciplier with 64-bit blocks should never he used lor 
more than four billion blocks (that lx:ing 232 blocks). 
Similarly, while a well-constructed 128-I>ii cipher is secure 
against anything but the most theoretical attacks, sucli as 
quantum compulens, a 2S6-hit cipher tempts one to say 
things like, ^'no one woukl ever need anyihijig larger," which 
this auihf>r might say over a beer, hut never in print. 

'llie AES pnxess attracted fifteen candidates by August 
1998, which were preseniccl at the first AES conference in 
Venium, California. In March of 1999, the second AES 
cojiferenee was held in Rome, Italy. At that txmference, analyses 
and lobbying were done for the ciphers. NIST will winnow the 
group down to hve ciplters in the .summer of 1999. Tlie third 
AES ccmference will 1 k^ in New' York Gly in April 200(}, atid the 
AES itself will he sciecied in mid-2(M)0, 

lYditically, the AES is inieresiing because it ct>me.s fnjin the 
same government that has the apparent policy of delaying the 
wiclespread use of cryptography for as long as possible. On tlie 
one hand, delay, and on she oilier a replacemcni for DES that 
genuinely pushes the state of the art. Le.ss interesting, but still 
woitli noting is that the scTcind conference being held in Rome 
has heljxxl the international a.spect of llie process. While the 
standard is a US government sUmdard, and the selection is l>eing 
made by NIST, only five of the pn>]:)t>sals <-ome from nominally 
LJS teams, and only one submissitm from solely IIS designers. 

This is interesting because it means that KIST ft as lo 
have a nunibcT of the documents about tlie AES under export 
control, including the ones that describe the fund ton ctf the 
prtxposed algorithms. Many of the official sites for algrtriihms 
are kept in off-shore locations. 

One of the interesting aspects of the AES Ls that there is 
a rec|iiirement that the AES algorithm run faster than Iriple- 
DES. This makes sen.se, most DES applications are moving 
toward using Iriple-DBS. and why bother moving to AES if 
you won't see a f)erformance improvenieni? However, a 
number tjf the siibmis.sions run faster ihan DES itself. For this 
reason alone, these algorithms are amt mg the favorites of 
people examining the submissions. 


At the Rom<f <'onferenee, a strasv fjoll was taken for people s 
favorite algorithms. Tlie results were for Rijndael (pnmounced 
rain-iloll), 1’woflsh, Serpent, MARS, and RC6. 

You can find more infomiatitjn alxnit the AKS on the web 
at <http://www.nist.gov/3es>, 

Frivate-Sector Developments 

There have lx.'en a number of otlier iniscellaneous 
tievelopments in the private setlor to export LT)'pct^raphy from 
the I.IS under the ainent regulations, and also to demonstrate what 
the airrent state of the an is. 'Hiiee of them are destrilxd below. 

DES CKiVCKER 

For many years, people speculated how^ easy it would i>e 
to build a machine to bruied'orce search the key space for 
DES. Of course, rhe estimate alw'ays decreased as the years 
wore on, and DES-cracking became .something of a sport in 
the last couple of years. In fad, there have been a couple of 
inieresting advancements to the art of fast ciphering as a 
result of the dLstributed.nei DES cracker Bui ir w^asn't until 
mid 1998 that DES-cracking became moot witli die creadon 
of ihe EFF's H)eep Crack" iiKu hine. 

Deep Crack is a scalable system irtade from ciisiom silicon. 
Sixteen DES engines are on each chip, and lliere are thirty-two 
chips on e;ich lx>ard trf Deep Crtick. "Hie machine can run in a 
configuration of an arbiimr)^ numiKTof fK)ards. 11ic machine, as 
configured for DES Cliallenge III, in Jauuaiv 1999, coukl search 
ihe entire 56-bit key space in 56 hours. 

Like many other cryptographic feats, the main effect of 
Deep Crack W'a.s to make a poliiiciil |Kuni. Over the years, 
people made esdmates as ui how mueh it would cost to 
make a DES cracker. Deep Crack was constructed for about 
what all the industry estiniaies claimed, and contrary to 
government estimates that were three orders (T magnitude 
over the actual construction cost. 

Ceeak Zone 

The Clear Zone initiative, also called “private dcKirlK'H'* is a 
propcxsal by eleven toq^oralions for relief on export restrictions 
for crypto systems that are not entl-to-end, for example, 
encrypting routers and other Vinual Frrvate Netw'ork devices. 

Tlie Clear Zone proposal rests upon die observation that the 
legitimate needs of [aw enforcement to examine netw'ork traffic 
mally need a tap to be filacvtl on one of the two ends of a 
TCPdF connection, tiecause of the w'uy that IE netw'orks are 
const meted, packets can take dilTereni rouie.s, and in fad 
heurisilcally tend to avoid anything that might slow diem down. 
Ccaisetjuemly. if you need to monitor a network connection, you 
want to put the monitoring equipiiieiil at one of the two ends. 

In the case of using eneryj^ting routers, for example, this 
means tliat a law enrorceineni lap is fxst placed on one end or 
the other f>f the connection. Thus, there is no need to limit the 
export of any ecjuipment that provides such a "clear zone." 

Under the proposed clear zone exemptions, a cry[Htjgrjphit^ 
system that provides a clear mm would lx freely exportable. 
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This, of course, does nothing for emhto-end ent ryption sysicnis, 
hill aiff>ws a category of usiditl sysLenis free cxix)it. 

A nuiiilK-T of systeiiis ate [>resently umier rev^iew l’>y the 
Depattnient of Gimmeire for export approval under this proptxsd. 

SOURCI: CODL PUBUSHING 

Tile present VA\< tegulations, the regulations that govern 
export oi' ciyptogniphy, have a sptxifk' exemption written into 
them. Thi'st* rt^gulaiions, like tlie ITAR regulations before tiieni, 
suite that *']printed material, including source code, are exempt" 
from the KAR. Over the years, various Ixioks with crypu>grai>liic 
source code in them liave tx:en freely published, while the binary 
code itself lias been export controlled. In fact, the Karn case 
revolves specifically around the fact that Schneier's “Applieti 
Crypiogniphy" lxH>k is freely exponed, along witli the source 
code in it, but that a disk with that source code is not exjx>rtah!e. 

fn 1997 and bW, Inc. and Network AsstKTiles Cwfiich 
lx)Ught PGP, Inc'. in Decemlicr 1997), started producing 
internationally available cr)'[)U>graphic sofm^are under thi.s 
excmptkjn. 'llie PPP als*> used this exemption to ptiblisli the 
source axle for the Deep Crack chip. Network Associates has 
also puhlishcd Lite sources to IETF OpenPGP reference code that 
did iu>i actually contain cryptographic modules, bm may have 
IxxMi nonethelt*ss restri( ted. 

The cxenipljon is sinijde in practice, but more difficult in 
execution, to use. One olxstacle is, of course, that the source 
ctxle will be freely available lo anyone who cares to buy tiie 
boEjk C{)nlaining it. Many systems creatoi^ do not want to 
[Hiblisii their source axle. Others, though, encourage it, and for 
them, this can be a useful way lo gel peer review of the 
implemeniaikm, (In fact, PGP, Ine,, who [mmeered source code 
publishing, did .‘X) as a way to get peer review as a way to disix*! 
fears that there were haw's or back ckx>r.s in PGR Ti was not until 
they piibli.slKxf several versions of PGP source code that applied 
for and received l>epartment of Commerce approval to st‘11 
compatible versioas of PGP based upon these .sr)urce IxHJksd 

Another obstacle is ihal under the EAR, providing technical 
assistance to foreigners is considered itself an export. 
Consequently, anyrme prtxludng software from published 
lxK)ks cannot do it with a.ssistance frotn ixople in the US. 

However, for those w illing to go to the trouble, publishing 
st>urce code can be a useful means to get peer review of 
software, as well as versions of it outside of the US legally. If you 
are inierested in gelling copies of tiie POP books, or the tools 
used to produce them, they are available from Printer's Inc. 
lxx>kstorc at <hRp://www,pibooks.com>. 

Till- Bernstein Case 

Hie fkmstein case is a suit filetl in US ftxier:il court to allow 
publishing of sou me eexie on die ncL FuQ details may Ik* found 
ai <http://www.eff,Ofg/bernstein/>, On May 6, 1999, the Ninth Circuit 
couri of appeals upheld a pre\aous decision that tht? ITAR and 
EAR export regulations are an unconslitulional prior restraint on 
free spc'cch. A conslitutional prior restiaint has to have a numlxT 
of ]m)iXMties. They are us follows: 


• atiy prior restraint must Ik for a sjxxified brief period of time, 

• the decisions of the agency respoasible for the restraining 
regulation must Ik .subject lo pronipl judicial review’, 

• there must Ik a clear decision-making process for the 
restraint with accountability built in to it, as opposed to one 
that gives the agency muc:h discrcTion, and 

• the licensing and restraint process must have procedural 
safeguards built into it. 

The Lippeals court ruled that the regulations, as diey apply 
to cryptogniphy, are unconstitutional. However, you should not 
immediately go our and start puidng c rypUj source axle on your 
wcl) site. Tlie government can apj^eal tlie decision, and most 
likely will Furthermore, even if the government does not 
appeal, it is a decision of the Ninth Circ uit, wliich covers only a 
nttmlxT of w estern slates, including Californiu. 

Summary 

Tins descrilKs many of die highlights of tite last year or so in 
cryptogniphy. The w’oi ld of cryptography is still one in which the 
legal and political hicets are as interesting as the technical t>nes. 

The overall situation is one in whidi the legal aspects 
are slowly becoming simpler The opposition to export of 
cryptographic sy.stems is gradually loosening up, and in a 
few cases, like in Franc'e, suddenly and completely becoming 
simpler. Jforhaps by this time next year, there will be even 
more good news to report. |£1 
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Carbon and PowerPlant 


Cregory* [k*w u the senior arthileci and ongitml author of 
fbu^^lant, which he started uniting for Metrowerias in 1993. 
iwrks fTym his home in Ccdif., ichere he has been let^ding a 

discusskm gnntp <f Mac pn^mmmm-for I2 ymn;. group metis 

eueryf other' ueek in a local resiat4rani sbaririg indiisiryf gossip and 
technical tifrs. <Jng tmpys helping J^ow programmers and he is a 
regular conirihutor io tbec{frnl)^y!s.mac.(Kp.lKmtnplatU neu^roup. 

Biography 

Gregory I>ow is the ori^iral aiiilior of l^owerPkint; which he 
siartcxi wanting in 199,1 Greg w'orks from his home in Berkeley, 
Qilifomia, whem he has Ix^en leading a discus,sion gnaip of Mar 
pn>grammers for 12 ytr:irs. Tlie group meets every other week in 
a local rcstauranl, si taring industry gossip and technical tips. Greg 
enjoys helping fellow programmers and he is a regular conLrihtvbir 
to the comp.sys,nriacax)p.powerpIant newsgroup- 

What is your overall opinion of Carbcin? 

Greg: I Lliink tliat Carbon is not only a wonderiitl tecimology, 

but also a great name. CarlHjn. It's the sixth elemenl in the 
Periodic 'fable. IPs the basis of all organic life. As gmphile, 
QtH>on j.s the softe.st substance. As diamond, 

Carbon is the hardest substance. In terms of puns and 
metaphors, Carbon puts the Mac 'i'oolbox at the same 
level as Java. 

On the technical side, I think there are two important facets 
of Carixm. First, C>arbun will nin on the upcoming Mac X 
as well as on all systems back to Mac OS 8.L Programmers 
don't have to choose lietween developing for the cutting 
edge systems and Ixdng compatible with a huge installed 
base of macliines - they can do [xjLIl 

Second, Carbon extends the life of existing source code 
because it includes a iaige subset of the classic Mac OS 8 
Ibolbox. Over the years. Apple has Ix’cn very good aixmt 
maintaining i>at:kward compatibUiry. When new OS versions 
come out, existing [xograms usually continue to work, or 
ret^iiire only minor modifications. You don't need to rewrite 


from scTatch. Cirlxm continues this imporUint tradiLit)n, 
although the required changes are ntore substantial 

What factors sliould someone consider before adopting 
Cartion? 

Greg; Moving to a new technology always entails some risks. 
Remembering ill-fated technologies as QuickDraw GX, 
OpenDtxr, anti Copland, some developers are naturally 
skeptical about Apple’s cornmiimeni to Caiixin. 

However, Apple has a gocxl track record with Qirbon.'Ilie 

Carixm message was ctmsisttmt at I he Worldwide Developers 
Conferences in 1998 and 1999. Carixm 1.0 shipped w ith Mac 
OS 9, and Qirlxm is indutlet-l in the Developer Preview 2 
version of Mac OS X. Also, by the time you read this article, 
Carlxm L0.2. wltidi runs on Mac OS 8.1 {>r Inter, will be out. 

One ptXential problem Is that does not sitip with Mac OS 

B. IXwelopcrs can licaisc C^iirlxin from Apple for ciLstribiition 
with their produtns. but this is an extra hassle that iniglil deter 
hoiTbyists. Furthemiore, the Cifb(.>n libniry is alxxtt 1 Mli In si2e, 
coasidcmbly large to bundle vviifi a small program. 

An(Hher problem Ls that QiTtxin tk>es not am on systems prior 
to Mac OS 8.1 and sy[>f>orLs only PowerPC machines. There is 
no workaround for ihi.s. If you need to sutifxm 68K macliines, 
System 7, or even eiuiler systems, you cannot use Carlxai. You 
would need to decide if it is w^onh the development eftbit to 
produce both Carlx>n and CkiSsSic versions. 

Dc'velopers with existing programs also need to make that 
s;ime decision. They sliould ask tliemscives, "do the Ix^nefirs 
of Qirbon outweigh tlie costs of j->orting the source code?" 
Carlxm is not a ainiime feature. It is not like the Appearance 
Munager wljere you are able to weak link a iibniry, then 
decide at nintime wJiether to use one set t>f routine's or 
another. You cannot gradually Carixinize. It’s all or nothing. 

In M;ic OS 8 and 9, there are nut any significant advantages to 
tising C^arhon, and Classic programs will still mn on Mac OS 
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P.O. Box 5200, Westlake Village, CA 91359-5200 
Outside U.S./Canada: 805/494-9797 
Fax: 805/494-9798 
877-NOT-DARK 
www.flash lightdepoLcom 


FLAS H light D E pot, your one stop shop for pocket lights, lanterns, 

POCKET TOOLS, AND EMERGENCY SUPPLIES! EQUIP YOUR OFFICE FOR THE NEXT POWER 
OUTAGE, MAKE SURE YOU'RE PREPARED FOR A FLAT TIRE ON A DARK NIGHT, OR jUST BROWSE 
THE STATE OF THE ART IN PERSONAL TOOLS AND LIGHTS! 
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Al'A^ays ready when you need jt, this powerful light plugs into an 
electrical outlet and stays constantly charged- When a power outage 
occurs it floods the area with light and can even be removed from the 
waif and used as a flashlight to light your way to safety. 
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This compact light Has dtial bulbs that can shine a 6.000 candlepower heana 
^Kross a football held or run for IS nights stmight on Its dual allcaline 
batteries. A hit with everyone, from fire fighters to campers, It's waterproof 
to 100 feet and protected to tough Faaory Mutual and CSA standards. It 
has a swiveling head and works as a flashlight, or uses a clever 360'" clip for 
hands-free operation. Rechargeable version also available! 



A cool way to connect with your friends and family. Only 7 ounces, the 
perfect solution for crowded conferences where cell phone reception 
is poor and you need to stay in contact with your team. A smart choice 
for working outdoors. These trail-blaiing two-way i^dios offer clean, 
clear communication whetlier it's fust for fun dr serious business. 
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The Leatherman Wave, the next generation of multi-purpose tool, has 
arrived with the most features of any Leatherman tool.Along with easy 
access to four exterior locking blades, the handles have been rounded 
for a great feel! Perfect traveling com pan ion I 
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X. Tlio advuniaycs comtj fn>ni Carlx>n on Mac OS X, wlicrc 
the three major benefits are protected memory, dynamic heap 
sizes, and pre-emptive multitasking. The value of these 
l>cncfils dcfKrnds greatly on what a program does, although 
all programs are better off with protected memory because it 
helps insulate a program from bugs in other programs. 

Dynamic heap sizes will help programs tliat use a variable 
amount of memory, litis includes programs that open 
multiple documents or otherwise deal with indeterminate 
amounts of data. Pre-emptive multitasking can make the 
entire system feel more responsive and is very good for 
programs that perform lengthy eumputaiit>ns or otherwise 
need regular processing time. 

Wliat kinds of changes wUl people need to make to 
support Carbon? 

Greg: I classify the differences between the Carbon and 

Classic Tot)llx>xes into three categories: syntaelic, interface 
modification, and feature replacement 

Syntactic changes usually rec|uire only one or tw^o line 
changes to source code. Tlie simplest are name clianges, 
where Apple has renamed a symt>ol in order to lx? more 
consistent with naming crinventions. Such c:hanges are not 
new to Carbon, as they occur with almost every new version 
of Apple's LIniversid Interfaces. 

Ollier symactic changes result from many Carlson Toollx>x 
data structures being opaque, meaning that their format is 
private and not directly accessible. You need to use an 
accessor function. For example, in Clas.sie, you can access 
tile font for the current port as follows: 

GrafPtr currentPort; 

GetPort(icurrentPort); 

sh<?rt currentFont * ciirrentPort >T3(Fnrtt: 

Referring to cu(TentPort->txFont dcf^ends on the exati size and 
layout of the GralPori strud. Any change to tliat struct and 
the above code breaks. In Carbon, you must call a function 
to get a pon s font: 

stiori CTjrrt?ni.Porii ^ GiJiFortTeKiForu (curteniPori]: 

Tile Grafl^ort struct is opaque, and not even defined in the 
header files for Carlxm. As long as the function 
GetPortTextFontO continues to return the font for a port, 
Apple can change how GrafTorts are implemented without 
breaking existing programs. This makes it muc:h easier for 
Apple to enhance tlie system software. 

Interface modification describes cases where Carbon and 
Classic have different ways for accomplishing the same 
task. A very simple example is initializing the Toolbox 


managers. With Classic, you need to call functions sucli as 
InitGrafO, InltWindowsO, and InitMenusO. With Carbon, you 
do not call any of these functions. Carbon initializes the 
Toolbox aulomaLicaily. 

Another example of different interfaces is the Scrap 
Manager for dealing with clipboard data. For Classic, you 
use the functions GetScrapO, PutScrap{), and ZeroScrap(}. 
For Carbon, you use the functions GetScrapFlavorDataO, 
PutScrapFlavorO, and CfearCurrentScrapO. There are small 
differences in how you use the functions, but it’s mostly 
a one-to-one correspondence. 

The Printing Manager also has a different interface in Carbon. 
There are new' data stnjctures and functions. However, there 
are routines for convening between the Classic and Carbon 
data structures. Tills Is very convenient, as a lot of Classic 
printing code relies on directly acce.ssing and storing the 
information in a l^rintHecord. 

The changes that will probably be the most difficult are 
feature replacements. Carbon removes support for some 
sy.stem features such as Standard File, MacTCP, and 
balloon help. Developers must convert code to use 
alternate Features that are supported. For the 
aforementioned features, suitable replacemen Is are 
Navigation Services. Open Transport, and MacHelp. If 
your programs rely heavily on an unsupported feature, 
you will have a lot of work to do. 

How have you impieuiented Carbon support in 
PowerPlant? 

Greg: PowerPlant 2.0, the version in CodeWarrior 
Professional Edition, Version S.O, is being enhanced so 
that it can be used to build i)otfi Carlion and Clas,sic 
programs. Carbon is another passible target for a project, 
along W'ith PowerPC and 68K, 

^ince Classic and Carbon have different interfaces, there 
is a lot of conditional compilation. Universal Jntertaces 3-3 
and later include Carbon support, controlled by the 
[preprocessor symbol TARGET, APLMAC.CARBON. 
PowerPlant defines its own PP_Target_Carbon and 
PP_TargeLCIassic .symbols. 

For the most part, 1 have tried to avoid having code within 
functions that looks like: 

#i i PPJfa r ge t_Ca r b qn 
// Csrlwii code htrt 
jlfelse 

// CIsLssic code tiene 
tfendlf 

Such code is hard to read and maintain. 
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In cases wlierc Carixm has new acmssor ftmcrioos, 1 use 
inline functions with the same name that arc defined only for 
Clas.sit'. For example, using the accessor for ilie font of a pan 
previously nientioned, 1 have defined: 

inline ehort GetPorlToKtFont ( GrafFtr port ) 
return port >txFt>iitr 

1 

This definition, along with all the other acceasor funaions that 
PtjwerPlani ustrs, is within a single header file and bracketed 
by an #if so that it is not only defined for Classic Laigels. The 
Power Plant sources always call the accessor function, FtJr 
Carlx)n, this is an aciual function call For Classic, the inline 
function l^ccomcs a direct access of the cbita value, 

In cases where Carbon and Classic have different 
interfaces, I define a common interface with separate 
implementations. For example, I have defined a tJScrap 
namespace with the functions GetData(), SetData() and 
ClearDataf). There are two implementations of each of 
these functions, one for Carbon and one for Classic, 
Client axle then makes calls such as UScrap::GetDataO, 
with the setting of the condttiortal compilation flags 
determining which function is used. 

PowerPlanl already has support for both Stanebrd File and 
Navigation Services using the same interface. Tfiere are three 


options: always use Standard File, always use* Navigation 
Services, and use Navigation Services if it is available at 
mntime (otiicrwise use Standard File)* For Classic, you can 
use any of these options. For Carlx>n, you must always use 
Navigation Services. 

Likewise, tlie PowerPkint networking classes have always 
provided an abstniciion layer that su[>poits tx>tli Open TniasfK)rL 
and MacTCR Under C*arbon, you must use Open Ihinspoit, 

How much work is required to Carbonize PowerPknt 
programs? 

Greg: 'lliat really depends on what the j>R>graiTLs do. People 

will need to do the same kinds of things that I did with the 
PowcrPlant sources. Fur simple pn^rams, that will mostly be 
tlie syntactic changes of using accessor functions. 

Priming is the biggest change, PowerPlanl will handle 
printing the built-in panes and views. But people will 
need to update cu.5tom views with non-trivial priming 
features (anything that accesses the PfintRecord). 

Otherwise, u|xlaiing an existing project requires minimal 
changes. You need to create a new target, remove some 
old files and add some new ones, and set up a prefix file 
with the correct options. 


Fight Boredom 

Let’s face it; Much of programming is boring 
and repetitive. Well, that's where the right 
tool can save days, weeks, or even months 
of your valuable time. 



Mod^h Vi0w~Contr0lt0r 

AppMaker’s generated code uses the MVC 
paradigm, it separates the user interface 
from application logic, making code easier 
to write. You deal only with abstract data; 
AppMaker takes care of the user interface. 


AppMaker 

Your Assistant Prograntmer 

AppMaker makes it faster and easier to make an 
application. It's like having your own assistant 
programmer. You point and click to tell 
AppMaker the results you want, then it 
generates “human, professional quality code” 
to implement your design. 


8eriptabt0 Applications 

AppMaker generates the 'aete' resource and 
generates code to access your data 
{Properties and Elements in the Apple Event 
Object Model) and to handle Events. 

Just $199 from www.devdepot.com li • O ‘W ‘B ‘R* S 

Dev e lopmen t 

P.O. Box 929. Graniham. NH 03753 • (603) 863.0945 • FAX 863-3857 
bowersdev@aoI.coin • http;//members.aol.coni/bowersdev 
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PROGRAMMER'S 

CHALLENGE 


by Boh Boonsira, Westford, MA 


Latin Sqliares 

A lalin Square of order N is an NxN array of numbers, 
where each number from 0..N-1 occurs exactly once in each row 
and in each calumn. Your Challenge diis inonlh is to construa 
Laiin Stjuares that are minimal, in the sense that each must form 
liie smallest NxN digit base N number, where the digits are read 
off column by column, one row at a lime. 

The prolotyjK' for die code you should write is; 

#lf dcflnedt_^cptusplus) 

(jKtern "•C I 
ffendif 

void LatinSquarest 

stiort lit r diiTH:TUiiK>fi cif the biLki ScjtMit- to he ^urierati.tl V 

short * latinSquaco r latinSqiiireIc + f*n| to squm' vaJuc low r, (xi c 7 

#if definedf_.cplusplus) 

I 

tfendif 

For example^ 

123^1 

2341 

4123 

3412 

is a i^tin Sc|uare wtlh die value 1234234141233412. It is not the 
minimal Latin Squaie of order 4, however, since die following 
Latin Square, 

1234 

2143 

3412 

432L 

foniLs die nu mber 1234214334124321. 

‘['he dimension of the squares you must generate will be 
less than 2**16. The winner will be tlie soluLiun that correctly 
computes minimal Latin Squares in the least amount of 
execution time. Code slxe and code elegance, in that order, 
will be the tiebreakers, m the event two solutions are within 
1% of one another in execution time. All Latin Squares must 
be computed at execution time - entries thai precompute 
solutioas will be disqualified. 

Tliis nK>nth's Challenge w-as suggested by Aaron Montgomery, 
who earns 2 Challenge points for making the suggestion 

'lliis will be a native PowerPC Challenge, using the 
Code Warrior Pro 5 environment. Solutions may be coded in 
C, C++, or Pascal. Solutions in Java will also be accepted, but 
Java entries must be accompanied by a test driver that uses 
the interface pnivided in the problem statement. 


Three Months Acx) Winner 

Congratulations to Tom Saxton for taking first place in 
the November, 1999, Putting Green Challenge. While Fm not 
sure that the next Rytler Cup teams will be beating a path U) 
his door for his four-putting green skills, Tom did soundly 
beat the three other entries* 

The l^itting Green Challenge required con testa a Ls to 
analyse a sequence of greeas described as three-dimensional 
points connected into adjoining triangles. Each green had a 
ftxed pin position, and several holes were played on each 
green from varying initial ball positt<ms. Complicating the 
Cliallengefs job was the fact that the propagation model was 
unknown, available only by observing the results of a putt. 
For each green, the contestants were given several practice 
holes rhat c'oukl l>e used to puzzle out the propagation 
model. Scoring was based on an award of 100 points for each 
hole successfully completed, minus ID points for each stroke 
taken (not counting practice luiles), and minus 10 points for 
each second of execution time (including practice time). 

Two of the .solutions submitted cl it! not manage to sink a 
putf for any of ihe holes played in my Lest match. One of 
those solutions simply liit the ball at the hole very hard, 
tiying IQ take advantage of a possible ambiguity about ball 
velocity in the problem siatement* I heard from enough real 
golfers w'ho had riiiimed the cup a few times that 1 had to 
close the velocity Urophole, Tom's winning solution is fairly 
straightforward. He takes 10 prjiciice shots on the first hole of 
the first green to esLtinate die drag eoeffieients* It does not 
attempt to analyze the contours of the green or to model the 
effect of gravity. Rut the drag model is good enough to put 
the ball in the hole with tmly one ]>ult on a level green, and 
with one or two putts on a flat hut gently sloping green. 

1 used three greens in my test t:ases, a perfeclly flat and 
level green, a flat but gently sloping green, and a green with 
more varied terrain. Five practice holes were played on each 
green, five scored holes on each of the first two greens, and 
20 holes on the final green. On the interesting terrain of the 
last hole, Tom's solution completed each hole succe.ssfully, 
taking up to seven putts to complete the hole. 

'iJie table below lists, for each of the solutions submitted, 
tlie numlKjr of holes successfully completed, the total number 
of strokes taken on nonpractice holes, total execution lime, 
the total score, and the size ami language code parameters. 
As usual, the number in parenlljeses after the entranFs name 
is the total number of Challenge points earned in all 
Challenges prior to this one* 
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Name 

Holes 

Strokes 

Time 

Score 

Code 

Data 

Lang 

Tom Saxton (138) 

30 

117 

3.148 

1829.969 

2224 

432 

C 

Brady Duoa 

10 

49 

2.435 

509.976 

1660 

380 

C 

a a 

0 

60 

0.42 

^-004 

568 

93 

C++ 

J,T. 

0 

210 

197-47 

^2101.975 

2580 

255 

C 


Top Contestants 

Listed here are ilie Top ConEestanrs for the Programmer's 
Challenge, including everyone who has aa'umulaied 10 or more 
points during the past tw'o years, 'llie nyiiil>ers below^ incliRie 
(X)inls awardtxl over the 24 most recent contests, inclLKling 
[X)ints earned hy this inontirs entrants. 


Rank 

Name 

Points 

Rank 

Name 

Points 

L 

Munler, Ernst 

237 

10. 

Jones, Dennis 

t2 

2. 

Saxlon, Tom 

146 

11. 

Hart, Alan 

11 

3. 

Maurer, Sebastian 

67 

12. 

Duga, Brady 

10 

4. 

Rieken, Willeka 

51 

13. 

Hewett, Kevin 

10 

5- 

Heitticock. JG 

43 

14. 

Murphy, ACC 

to 

6. 

Shearer, Rob 

41 

15. 

Selenqul, Jamd 

10 

7. 

Borinq, Randy 

39 

16. 

Smith, Brad 

10 

8. 

Brown, Pat 

20 

17. 

Stroyl, Joe 

10 

9- 

Hostetter, Mat 

20 

18. 

Variily, Patrick 

10 


There are three ways to earn points: (1) scoring in tlte lop 
5 of any Challenge, (2) being the first person to find a bug in u 
published winning solulion t>r, <3) being Uie first person to 
sugge.st a Challenge that 1 use. The points you can win are: 


1sl place 

20 points 

2nd place 

to points 

3rd place 

7 points 

4th place 

4 points 

5th place 

2 points 

finding bug 

2 points 

suggesting Challenge 

2 points 


Here Ls Tom’s winning Putting Green solution: 

PultingGrcenx 

Copyright © 1999 Tom Saxton 

“PutTingGrecji.ti'* 

<stdlib. h> 
flliiclude <Hiiittuh> 

enuiQ 

f 

ffalse * 0. 
fTrup - TRUF 
I: 

tfdpfinQ OlM(ii) taizeof (a)/siEeaf({a) 10))) 

// dbablc assens 
#detine Assert(f) 

// vcatif arjcl ctMisiants 
typedef strtjct PointSHnoublo VEG: 
fjtatlc ccinflt double opsllon - l.Oe /: 
static coriiiL VEC £_ntjrDmlZ = [ 0* 0, 1.0 h 
static const VEC E_vecZero; 


The most powerful Email and Webform management tool available! 


Document Express is: 

• E’Busioess Website 

• Customer Service 

• Customef Databases 

• Marketing Center 

• PersonaiizedAuto-Repiy 

• Piug-in Extensible 

Docment Exfness Is for: 

• Webmasters 

• Site Administrators 

• Software Deveiopers 

• Internet Specialists 

• E-BusIness Startups 

• Website Designers 
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Reduce support costs and increase customer satisfaction, 
integrate Customer Service into your website immediately. 


Personalize every automatic response. 
Increase customer satisfaction. 


• Immediate acknowledgement. 

• Automatically generate tracking numbers 

• Never let a complaint or comment go unanswered 

• Easily notify ail your customers of special offers or updates 


Track file downloads, purchase requests, bug reports. 
Automatically generate serialization codes. Smart 
rutes-based auto reply and custom email roubng. 
Pnoritize customers and issues. Easy-to-use 
interface m^s learning a snap. 


Account for each email message and every e-customer! 

• Reporting of each Webform submission 

• Increase quality control 

• Automafically build customer base for online promotions 

• Implement customer service and support right into your website 

• Convert casual inquiries into sales opportimilies 

• Message customization to targeted customers 

• Maximize customer retention 


Attention, Metrowerks Code Warriors!! 

Use the Dcxtumenl Express Module [ievelopment Kit with 
Code Wam'or to create custom solutiotts just right for any 
business. Our software is iully extensible and flexible. 


Document Express 

7911 Herschel Ave., Suite 409 , U Jolla, CA 92037 • 858 - 551-6767 


Download a free demo version at: 

http://vvww.documentexpress.com 
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// ihLs green 

static PointiDDoyble *s_papoeGridr 
static tnr R_cpt>flGrid: 
static HyTriangle •s_patrli 
static int s_cLrl: 
static int s_ltriHin; 
static Point3D0ouble s_posPin: 

static int B_ch£> 1 ePrac t ice; If number of praaicc p^irw 

static int s choleScoted: // number of scoittJ putis 

// computed physical cc^nstants lor this green 
static int u_fGetDrag “ fTrue: 
static double mDragt bHragr 

// cumni state 

static int s^iboie; 
static int s eputt: 
e La tie Im s_f Practice: 
static PointIDttouble s_pofiCur; 

// Lbc Ciirrent putt 

static double E_svlnitiai; 
static double s_dlstE3tpect: 

// \iKtfir miliiics 

static void _SubVecCVfvC posL VEC pos2« VEC ^pposResult]'• 
static double _DotVectVEC vccK VEC vec7j; 
static double _LenVec(VEC vec}: 

static void _ScaieVec(VKC vec. double s* VBC *pvecRcsuUJ: 
// triangle uitliile;^ 

static void _GetHidTriPofl(int itri, PointlDDouble ‘ppos); 

// 

// tiniry J^incs 
// 

iM f 0 

static void_Entry„PolntsC) 11 

ifcndl f 


initiireun 

void InitGreen( 

Polnt^DDouble paposGrld | ] , /* green icnuln dcsaipUun V 
long eposGrid. 

HyTriangle patrif], 
int ctrU 
long itrlPln* 
long cholePractice. 

long choleScoted 

) 

1 

s_papDnGrld = paposGrld: 
a_cposGrld = cposGrfdr 
s^patri “ pairi; 
s_ctrl - Ctrl: 

E_itriPin * itriPin: 

s cholePractice “ cholePractice; 

R_choleScDred ^ choleScored; 

_Ge iHidTriPos ( U r IP i n . fcn_posPiti) ; 

s_ibole " 0: 

I 

iKpragma varn unusedarg off 


.staiil lule 

void Startllolei t ailed eo siari play on this holt 7 

PointIDDoubie posStart» t iniriiil ball position on the green 7 

Boolean fPractice /*TRl lE if thb hole is pnakr 7 


S_posCur = posStarti 
S^cpuil = 0: 

s_fTractice “ fPractice: 


j^pragma wam^unusedarg reset 

lldefine cputtPractice 10 
ifdefine cputtScore 10 

typedef struct SIJ SC: 
struct SB 
1 

double speed: 
double diet: 

I: 

static SD E.asdfcputtPractlce]: 
static Int s_cfid: 


MakcPutl 

Boolean /* quil 7 HakoPuit f 

VelocityZDDouble *pvX¥ t return tiiitbl ball vcJucity in the plane 7 

) 

I 

double dist: 

PointSIllkHibie vXY; 

it (s_cputt >= (s_fPractlcc 1 cputtPractice : cputtScore)) 

I 

if (s^fGetDrag) 
i 

int isd; 

double suebY, sumXY, suinXX: 

Assert(s_csd > 0); 

// do bncar rtgrcsMOii E>n ihc tiaiii 

EuraX ™ stusY ^ sumXY “ supiXX 0; 
for tied = 0; Isd < s_csd: ++isd) 

I 

SO ’psd = &s_asd[l©d): 
double y = psd >diai; 
double K ^ fabsipsti >speed); 

sirmXX X * }t: 
sumXY 4= X * y: 
siimX += x: 
sutnY +“ y: 

1 

nDrag = (sumX'^sumY s_csd‘siirBXY)/(EiiimX'sumX B_csd*stMXXj: 
bDrag = (sumY - aiDrag‘suBiX)/a_C!jd; 

AssertfO.O <“ aDrag nOrag <= 5.U]; 

Assert(-5.0 <= bDrag && bDrag 5.0): 

S_fGet0rag ffalse; 

I 

// give up 

return fTrue: 

I 

// jiJSJ give up after weVe finished with pracThc idiois 

if (s_fl'ractice && !s_fGetOrag) 
return fTrue: 

_SiibVec{s posPin, s posCur. &vXy): 
vXY.x - 0; 

dist ^ J,enVcc(vXY); 
if {s_fGetDrag} 


// which hole arc wc on? 
// which pull is this 
// is this a pracLicc putt? 
// w^bere's the ball? 


r number of points 7 
t triangles comprbmg the green 7 
r numlxTor triangles 7 
r index in triangiesl] irf the pin ilib gnxn 7 
r number of unscored (hut timed) hok*s to 
pranit'c m this green 7 
t iiunivT of huks to be scored on tliis gpt'wi 7 
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t 

s_svlnltisl = 3*0*El-0 + s_cputt/2); 
if (s_cputt % 2J 

s svlnitial * -s_svInitial: 

I 

elfie 

I 

!>_svinitial * (dlsi + 0*03 bDta^j / mOragi 
s^distKxpect = dial: 

I 

^ScaieVecEvXY. s_6vlnitlal/clist * S.vXy); 

pvXY'>x ^ vXY*x; 
pvXY >y » vX¥,yj 

rctutri fFalflc: //ktTp j?£Jing 
I 

IkiHMovcnicni 

void BallHovement( 

ha 1 iPoai t \on papnnA 11. T idt*s Nt in itjiponst to Makclhiit 7 

\ nr epos. r number of ball ptwitiofts pfTmdeti 7 

Boo lean r T n Ho 1 e /* tnic if f he bal I went i nto rhe hok* 7 

) 

I 

Point3DDoubie posHa¥: 

posKew = papos4 kpos * 1T * pt: 

if (IfTtiHoleJ 
( 

double dial: 

FointlDilguble vecMove: 

„$ubVec(pOBNew. s^posCutp ^vecMove): 

dist “ J.^nVec(vfcHove); 

if (b fGfitDrag) 

I 

A 0 'jeri(O a_csd C !>TM[s_asdl): 

s_as(J [s^esd] . speied “ fiibaEs_avirLitial) r 
s^asdjs^csdj ,diBt = dist: 

’*+s_csd: 

1 

1 

s_pof.Ctir * posNew; 

1 

// 

//Vector Functions 
// 

iflf 0 

Slack void _Veclor_FuncLlofis(H 1 

>ubVcc- 

static void SubVae(VEC pofllp VEC pos2, VEC "pposEesult) 

I 

ppor.Rfimilt’>x * port Lx - ponS.x; 
pposRenulL >y posLy posJ.y; 
ppoaRoiiuit >2 = posl .2 pos2.x: 

I 

DotVee 

static double DotVecEVEC vecL VEC vec2) 

I 

return veel.x * vec^.x + vecl,y “ vee2,y + vccLx * voc2*:c; 

.U'iiVcc 

static double _LenVec(VEC vec) 

I 

return sqrt(_Dor,Vee{vec, vec)3: 

I 


iicalcVtc 

static void _SealeVerjVEC vec. double b* VEC *pveeResi)it) 

I 

pvocResult >x ^ s * vec.x; 
pvecKesuit )y ” s * vee .y: 
pvecKesiiIt->z = s * vec*z: 


_GotMidTriR>s 

stoiic void _GeLKidTriPoa(lnL ilri* PolntlODoublp *pposMld) 

j 

MyTriangie tri: 
lot iipos: 

Assert [0 itri Lit itri < s._ctri); 
tri “ s_petrj titeij : 

•pposMld “ 3_veeZcio; 

for (lipos = 0: iipos < iUM [tri. point indices 3; -H-iipos) 

I 

?oin13 DDoub1 1 * ppo s: 

Assert(0 trl* pointIndicesfliposl Ai 

rrLpDintTnd!een[i Ipos] < s_cposGrld); 
ppos ” is_paposCrid[trl*poLnnrid IcesE I Ipos]]; 

ppoaHid >x += ppos >xi 
pposHid->y += ppos->y: 
pposMid->z ppos->z: 

J 

pposHid->x *= J*{}/3.0: 
ppnsHid>y 

ppoaHid >z ‘= I.0/3.0; 
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EMERGIMC 

TECHIUOLOCIES 


By Kas Thomas 

Scalable Vector Graphics: 

An Introduction for Programmers 


Learn bow this important 
new iveb document 
standard will impact web 
design and (quite 
possibly) OS X imaging 


The Woild Wide Web is primarily a 
iHsual medium, and the primary unit of 
informal ion display on the we!> today is 
the paj^c — the web page. But despite 
rapid progress in offiine document 
teciinology, ihe tmh page continues to 
be based on an 2 irchaie imaging model. 
The HTML tlJyper^Text Markup 
language} display technology upon 
which 99^^ of the w^orld'.s web pages are 
built w^us never designed to 
accommodate 48-bit color^ realtime 
animation, on-lhe-fly antialiasing, 
infinite zooming, vector art, embedded 
I’ype ] fonts anci professional 
typography, pixel-accurate positioning 
of page elements, or any of the other 
DTlMnspired features modern computer 
users have come to depend upon in 
their daily work. In order to make high- 
end display features like these possible 
in HTML, nothing short of a complele 
rewrite of the HTML documcnl mtxicl 
would be needed. 

Fortunately, that rewrite has just 
l>ecn coiTif)icLed l)y the World Wide Web 
Consortium (W3C) and is now ready to 


enter service. The formal standard is called Scalable Vector 
Graphics (SVG) and can he found online at 
<http://www.w3.org/TR/SVG>. 

I’ar more than just a graphics standard, SVG is a full XML 
grammar (with a public Document Type Definition) and an 
as,sociated XML namespace, meaning that SVG can encapsulate 
not only images or text, but standalone documents. You can 
embed SVG files inside HTML pages using the traditional 
<EM8ED> tag; or you can write whole well pages as freestanding 
fsvg' files (pnwiding your server is set up to serve such files with 
a MIME type of image/svg’). Any well-formed XML file can 
emlx.xl SVG, and (conversely) any SVG file can emfxxJ well- 
forincd XML — including SVG itself. 

In the coming weeks and months, you're going to be seeing 
and hearing a lot more about SVC. In fact, SVG lia.s even Ixicn 
incnlioned as a passible basis for a future QuickTime Image 
Importer (sometliing that, if it happens, will probably happen in 
the next 12 months); and in a talk given at WWDC last Fall, 
Apple's Peter Gmffagnino (Director of Grapliics and Imiiging 
Software) hinted that developers targeting OS X might want to 
consider providing native SVG support in graphics programs. 

Given tlie increasingly significant role SVG is likely to play 
not only in web graphics but in desktop gi-aphics, now might be 
a goocl time to become better acquainted with this exciting 
Lechnoiogy. In this article, weTl look al SVG finil as a dtxument 
standard, with a view to understanding how its pieces fit together 
for maximum crc>.ss-platform interopenibility. We’ll have time to 
say wt)al or two about forthcoming Uk)Is for working witfi 
SVG; then we ll lake a look at mw SVG code and try our liand at 
some JavaScript animation efTect.s in SVG, WeVe got a large 
amount to cover in a short space, .so let's hi I I he ground running. 

What Is SVG? 

In a strict markup-language sense, SVG is any XML 
document that adheres to tlic dtxunicnt tyjx; definition at 
<http://www.w3.org/Graphics/SVG/SVG-19990812.dtd> (or equivalent 


Kas Thomas <kt@svgcenlnil.L’t>iTi> Ls writing books on PDF :ind SVG and i.s the perpetrator of <www.acroforms.com> as well 
a^s <w w w .svgcentni l, com>. 
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mor-e recent version) and conforms to the rules set out in the 
standard at <http://www.w3-org/TR/SVG>, But SVG is more than just 
a bi^set and a grammar for asscHriating styles and atlributes widi 
graphics primitives. It's a philosophy for how text and graphics 
information ought to be encapsulated, manipulated via code, 
and rendered to output devices at runlinie. 

In a way, Scalable VeGor Graphics is a rather peailiar 
moniker, with a redundant ring to it. kind of like Teelable Yellow 
Bananas." After all, vector graphics are ^ naiurv .scalable (i.e,* 
capable of Ix^mg enlarged or reduced indefinitely without 
resolution loss); you wouldn't think that point needed 
reinforcement. Rut maybe it does. We're all so accustomed to 
seeing GIF and JFEG files in fixed resolution on our browser 
,screeas tliai the tlioughf of web graphics Lieing infinitely zooniable 
(much less rotatable or dr^rgg^ible) hardly seems natui^ah 

Vector gmpliics lend tlicniseives to rescaling because they 
are not predrawn at any set size, as JPEG, YiFF, Glh\ and other 
bitmapped images are. Instead, vector art is rasterized at the last 
possi[>ic minute, on the user's rimcliirrc, using tlie maximum 
appropriate ptxels-per-inch resolution for the output device in 
question, even including supersampling to achieve antialia,sing. 
It's this peculiar characLerisiic of ""late pixel binding" that gives 
vector graphics its versatility and power. Wlien you virtualize 
your art elements — dealing with them in the abstract, drawing 
[hem only at the last minute (“just in time") — you can set up 
your render pipeline to perform any number of coordinate-space 
manipulations, alpha-channel operations, opacity ramps, blends, 
ma.sks, clips, warps, mcjrphs, overlays, etc., in any combinatkm, 
without the slightest bit of resolution loss, bemuseyvu haven't 
drawn anything yet. Once all die vector-space manipulations are 
complete and the user has c:hosen an (mtput resolution, monitor 
iikkJc. zoom factor, and so on and so fortli, rasierizaiion can 
begin, 'I'hen the image gets drawn — at die highest level of 
perfection attainable. 

PostScript afidanados will recognizx* tile concepts descTibed 
here as inheriting direedy from pioneering work done by Warnodc 
and Geschke in 1984. The .same concepts underlie PDF (as well as 
Adolx’ Illustrator and MacR>mcdia Flash). But ratlier tlian using llie 
postfix notation of PostScript, SVG uses ordinary markup-language 
tags to enopsulate dniwing information, so that, for example, to 
draw a rcd-fillcd circle of radius 25 at an x-y position of [1(X),1(X)] 
on the screen, one need simply do; 

Ccircle ck=" 100'* cy="100" Etyle=’'fill:red" /> 

In the circle tag, the cx and cy attributes give tlie centerpoint 
coordinates of the circle in the current coordinate space (w^hich by 
default lias its origin at the top left comer of the brow.scr window 
or cunent viewport, with y increasing in die downw^ard 
direction), Y gives the radius (in pixels, unless another unit .system 
has l)een defined), and die style aUribuie specifies how die circle 
should be drawn. 


Ihe various builtdn SVG geometric primitives and their 

associated lags and aUributes arc shown in Table 1. 

Shape Required attributes 

<£:ircle> cx, cy (center point ctxirdmatcs) r (radius) 

<ellipse> cx, cy (center point coordinates) rx (radius in x), 
ry ( radius in y) 

<rect> X, y (ccxirdinates of die top left comer) width, height 
(rectangle's dimensions) optitmal: rx, ry (radius of 
comers, if it is to be a Younded recG) 

<line> xl, yl (coordinates of starting point) x2, y2 
(ecK)rdinaLes of ending point) 

<poiyline> points (pairs of numbers signifying the cxxirdinates 
of points on a line) 

<polygon> points (pairs of numbers signifying the coordinates 
of points on a line) 

Note: Ihe dijference hetiveen apolyUne and a polygon is that the 

polygon is auionmtically closed (and Ihm filkihle). 
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<p^lth> A,C.Hjl->1,Q,S,T,V,Z operators, plus coordinates or 
numeric offscls. (Note ihal ca[>ilal letters denote 
absolute-coordinate operations; lowercase denotes a 
relative operation.) 'fhe various operators stand for: 

A elliptical arc 
C cubic better ciirveto 
H lioriztmtal lineio 
L lineto 
iVI moveto 

Q <iuadralic bezier curveio 
S smooth cubic l:>ezier curveto 
'F smooth quadratic l>ezier curveto 
V vertical lineio 
Z closepath 

Table 1, sSVf? Drauing Frimiliim. 

You 11 notice that whenever a parameter value is called for, 
it is ^iven Ix^iween (juoiaiion marks. (Also note that the entling 
tag is a forward shush ibllowed by a greatest]lan symbol.) In 
general, tile arguinents and parameters to a dniwing element 
aren't called arguments and parameters, but atuihtues and 
values, Ttie atlnbule is die thing on tjie left side of the equal sign 
(such as cx), while the value is wliatever is between quotation 
marks on the righi side. 

BumapfI'D Graphicis 

lest you gel the idea diat SVti is .simply a vector-graphics 
engine, bear in mind that you can embed bitmapped gmphics 
inline in an SVG file using almost the same syntax you w'ould 
use for putting Glh' or JPEG images in an irPM! file. An example 
of the syntax is: 

(image x=”lO’' width"lOOpx" height="lt)Opx" 

xl i nk: href="Kiypic, png" ></ linage > 

Thu ‘x' and attribiilus refer to the position where the top 
left corner of the I'titmapjx.xl image shouki ap[X"ar. The ‘width* 
and height* anrihutes describe the dimensions of the destination 
viewport for the image (in this case, in pixels). Youll notice that 
the IIKL is refeieneed with an 'xlinkdirer tag insiead of ilie mure 
familiar liref notation. This is die XML way of denoting a link 
to an external VRl. All links — even to anchors within the host 
document itself — are treated this w^ay in an SVG file. 

File image file in this example is a PNG file: an image in 
I he Portable Network Graphics format. This is one of two 
bitmap formats SVG supports, tlie other being JPEG. Wliat 
about Gil? As it hapjx^ns, there Ls no support For GIF, That 
doesn'i mean that shipping softwai^e products that .support SVG 
won't incorporate GIF support; some no doubt wall. The formal 
SVG specification doesnl reqtiire GIF support, however. The 
rea.son for this has to do with patent rights. 'I'he Graphics 
Interchange Formal (developed originally by CompiuServe) 
uses Liv-ZempebWelch compression as the defoult 
compression method. It turns out that this compression metkxl 


is covered by a patent that Terry Welch took out in the mid- 
198()s on hchalf of his employer at the lime, Digital Etfuipmeni 
Corp, ThroLigh a series of corporate acquisitions, the patent 
ended up with Lfnisys, which in recent years has been sending 
its minions around to make sure users of the FZW algorithm 
pay royalties on it. This was enough to convince tiie W3C to 
abandon GIF support in SVG. Even though the Welch patent 
expires in 2003, there will — for now be no formal 
requirement for GIF suppcjit in SVC. 

In a greater sease, it ck)esn t nruitter, l-jectiuse FNG, which was 
cieveloped spedfiatlly to replace GIF, is a big win for all c:oncemed. 
Its featLire set Cwliich includes st>ptiistic'ated kx'csiess compression, 
alpha transparency, interlacing for progressive download viewing, 
onboEird gamma adjiLStment, advanced chec'ksum and COTUpiiorh 
detection tecliniques, and much mom) goes well Ixiyond GIF's 
c'tipahiliries, and sinc'e the souvee ccxJe is freely available, consistent 
implementation of die feature set is virtually guaranteed. (For more 
information on PNG, see <http:y/www.cdrom.COm/puh/pn9>.) 

If you’re worried about not being able to offer advertisers 
on your site the ability to use animated GIFs, relax. Ibere’s 
something much better in store: namely, animated SVG. (Well 
get to that in a minute.) 

I'EXT 

SVG's greatest visual impact on the World Wide Web, 
paradoxically, may vejy^ w^ll come in temis of text. With SVG, a 
page containing mostly text (and let s face it, most web pages are 
primarily text) can he prolessionally typeset, drawing (if you’ll 
pardon the pun) on Tyi>e i fonts in any size, .style, color, or 
leading. Also, just as with PDF, fonts don't need to l:>e present on 
the u,scTS machine in order for a page lo lx* imaged properly. 
Externally linked font resources can be supplied, and — if need 
he — the browsing application can retrieve needed resources 
from the appropriaie FIKKs) in real lime. 

What it means is that web pages, if written in SVG, could 
end up looking a lot more like magazine pages and a lot less 
like TTY emulaiicm, with text that is /ooinahle (and properly 
aniialiasecl) yet ckx^sn't reflow^ every time the window is resized. 

In SVG, text takes two forms: its ASCII (or Unicode) 
entxxied form, and its stroked/filled form. The encoded (brm is 
always present inside tlie file, wlierc it can lx* travei’sed by 
search engines, But most of the time, we’re really talking ahejut 
the giaphical representation of text: fill color, stroke color, size, 
tj[)aeity, diaracter width, and so on. Remeinhcr tlial in SVG, as 
in Pc}stSciipl and PDF, everything tliiit gets painted to the screen 
(except for inline PNG or JPEG graphics) coasists of strokecl 
and/or filled pat I is. That includes font diaracters, wJiich are just 
dosed liezier-cLirve paths. 

Specifying text in an SVG file is almost as easy as specifying 
text in an HTML file. For each text element, you simply do 
something like this: 

(text y^"144" style^“fill:blatk:fotit- 

in 18-point 

tie 1 vet ica. (/text) 
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'Hie text m Lhi.s l)kx.k — whtcli says ‘'Tliis is 18-poinf 
Helveiio.” — will lie drawn one inch (72 pixels) from the left 
side of the viewport and m'o inches (144 pixels) dtjwn from the 
top, Tlie style aiirthiiie contains propeity:value pairs for fill color 
(hlack). iyi>eface (Helvetica), and type size (18 points). Note that 
text hIcK’ks must lie terminated with a </text> closure* 

A.S you can see, this is not a terribly difficult syntax to master 
T'he only part tliat may cause some consternation is the lati that 
each line of text you put on a page has u> have a sfiedlled 
starring position. Text dcK^snl wrap auioimticully. . Tills Is eidier 
a l>lcSiSing or a curse dcfiending on your oudook. For most users, 
most of the time, line-wrap won’t lx* a problem, f)eeause most 
users will rely on commercial autlioring apjjs (such as Adobe 
GolJve, whicli sviil feuturv full SVG suppriit) to prcxiuce line- 
wnipjx^d SVG text automaiiolly. K\^en Adobe lliListratt)r (which 
has an SVG export plug-in) dcK's a fair job of justifying large 
bkx'ks of text. It's only at the (low) level of haml-iTafling your 
own SVG files in a text editor that you have to “sweat** things like 
line breaks, tabs, and interline spacing (leading), 

STY1.RS 

SVG suppems inline, emlx'dded, and/or external stylesheets 
under CSS2 (the standard for Cascading Style Sheets), and also 
allows font einL>cdding. w4iich means a couple of things. First if 
you're conilbrutlile alreatly with CSS .stylc'siieel coiiveniions vis- 
a-vis riTMI. 4.0, you'd feel right at home with SVG, Ixx'ause 
youH use the same syntax to define styles and .selectors in SVG, 
jilacing style sections Ix^tween <:style></style> tags. Secondly, ihe 
font-embedding capability means you won't have to wcirry aliout 
whether your user has. say, Antique Olive fkild on his syslem; 
you can provide external links to font re.srmrces, and the 
viewing application, if it can't find tlic needed resources on the 
host mad line, will auromatically retrieve the fonts it needs via 
htt[X (Don't worry alx>ut licensing issues where genuine Adobe 
fonts are concerned: tlie various Adobe apps that support SVG 
will export font subsets autoimtically, and Adnlie has taken a 
litxTal |X>sti!re on the use of its Type I fonts for web puqxxses.) 
In genenil, many of the same rules that apj)ly to PDl- files will 
apply to SVG. Namely^ To .save bandwhdth, you shoyidn'r go Tof> 
crazy with font usage; alw'ays subset rather than embed die 
whole font; and you c:an safely assume ihat all users w4ll have 
a<mss to the basc-l4 printer fonts (Helvetica, 'I'imes, and Courier 
families, plus SyTnbol and Zapf Dingbats). 

S'JKDCl'URL 

In lenas of structure, an SVG file follow^s s^ime kiirly simple 
organizational rules. At a bare minimum, an SVG file will lx* 
matle up of a header section fodowed by the “contents'" of the 
dtxLimeni set Ixtw^een a pair of <svg></svg> rags, Tw'o fairly 
typical optional components are CSS siylesheets (which we just 
dis^’Lissed) and emlxddtxl JavaScrif^i. Stylesheets are ejnbedded 
using <style><7styte> tags, while scTipts are enilx^ckitxi using 
<scnpt></script> tags. (Stnmcl familiar?) Tlic ordering is not 
importanr. You on have the graphics content first, followed by 
stylesheet inlb, followed by javaScripl functions, or any ordering 


of dio.se cc)mp<jnen[s that suits your taste and w'ork habits. For 
parsing, it doesn t matter. 

The header portion of an SVG file looks a lot like the 
header portion of any XML llle, excejit that the D'H) reference 
ptlints to a Document I'ype Definition (on the web) that pertains 
.sepcifically the St^alabie Vector Grapliics Ole, as you’d expect: 

<?xml version="1.0*^ «*ricodiiig-“iso 8859 r?> 

CIDOCTVPE ava PltflLIC " //W3C//DTD SVG 12August 1999/yEN’* 

“http://WWW. v3.org/GraphiCs/SVG/SVC~199908l2.(iLd"> 

<fjv£ jcwl: Space=*"preserve" tflcith=**400t3” bslglit='*3000*'> 

The reference to “Lso-^S9-r in the first line is an indication 
that the SVG file in question is in ASCII format. (International 
Standards Organization standard No, 8839-1 is, in fact, the 
American Standard Code for Infbnnation Interchange.) If you 
were to infer from thi.s that text enctxlings other than ASCII are 
possible, you would ix correct, SVG is a thoroitghly mtxiern 
.sundard. able to support Unicode and (pritentially) other 
encodings besides ASCII 'Ihis means, for exatiiple, that it Ls 
possible for users of CJK (Cliincse, Japanese, and Korean) 
hmLscLs to create SVG files in their native encodings. ,So if 
Western cultures decide not to emhnice SVG. iiN still jiossilile 
that other cultures wall decide to run circles around us with it. 

The .second line, Ixginning with fDOCTYPE, gives SVG 
version info (the version info in line one applies to XML) and 
tells w'here the DrK umeni Tyfx DcTmiiion for SVG can be found 
on she web. In tlicoiy, this provides a mechani.sm whereby 
browsers and view'ing applications can lu' self-updating, 
retrieving the latest SVG grammar and syntax rules on an a.s- 
needed imis .should they lia[)fxii to lx revised. 

Tile third header line identifies the rest of the file as 
constituting the SVG contenis. The xml;space-"presefve” notation 
gives the viewing application some idea of how- to handle 
whitespace chanteters (such as tabs ), namely by treating them 
as individual .spaces rather than, .siiy, collapsing adjoining 
whirespat'es into ii single space. The width and height numlxr.s 
lell how big a drawing canvas (virtual drawing space) to allot to 
the SVG contents, in debniii user-space uniLs (i.c.. pixels). In this 
case, rather generous dimensions a[]ply. What happens if the 
screen dimensions are only 640 by 480? Nothing. The image's 
“live viewing area" will simply t'onsUiutc a 640x480 peephole 
into a total canvas area of 4(XK) by 3000. Anything that won't fit 
into the mt>niior space simply gets cropped at the etlges. Ikji 
you can still .scroll or hand-mf>ve the image as necessary to see 
other 'h)ff the edge’’ j^oriions t>f the image. Also, most 8VG 
viewing applications su[>ixjil zcK>ming, so that if the image Is 
actually 12{K) by 900 pixels in size, but the nioniuir is imly 640 
by 480, zooming out by a iwo“to-t>ne tacU>r will bring the entire 
image into view. 

With everytliing weVe said thus far, weTe ready, finally, to 
show the complete ctxle for a standalone SVG hie (see LLstiitg 
1). The image thai iliis file [^nxluces is depicted in Figure 1. 
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Figure I. The image fmiduced the code in Listing 1. 


listing 1 ; Log o.sv8_ 

l«gi).sV|S 

CTxral versitjn=”1.0" encoding*^"iEO-8859-l“?> 

<|[)OCTYPE svg PUBLIC "-//W.1C//DTD SVG HAugust 1999//EN’* 
••http://www,w3,org/Graphlcs/SVG/SVG-l99908l2,atd"> 

<svg xml:space**"preserve" wldth="iOOO'‘ height“'*lOOO'’ > 

<siyle type“*text/cES"> 

.redfililfillL#FFOOnOiI 

.whitowards I font familyiTimes-Boldifont- 

Eize:36:fill:i?FFFFFF:l 

.circDuSolell(f111:#FFFF22:stroke width;4:stroke:|ODOOFF:I 
(/style) 

(circle cy“"l00" r“"40" class^"circD\iSo1eil" /> 

(g ld=''topLayer'‘ 

traneform“**stale(l .2 1) translate(70 40) rotatetlOj") 

(reel class""redfill’* x="l0" y="0‘' width-***2fl3" helght*"40" /> 
(text claEE'="whitewords" x="20" > Powered by 

SVG.(/text) 

</&> 

</svg> 


Tiic code is straighrfbi'ward. We already discussed ihc 
meaning of the header lines. Within the <style></style> block, 
we have three CSS style selectors, nanied rc'dfill, whiiewords, 
and eircOuSoleil, If you'fe accustomed to CSS style syntax, you 
should Ira VC no Uouhie deciphering the contents of these styles, 
t he first graphic element is a circle centered on x=2Q0 and 
y=100, with nidius 40 user-space units (pixels, i)y default). Wc 
iiave used die cla.ss ke>T?vord to specify a style from our style 
segment. The "circDuSoieil" style, in this case, is made up of a 
yellow fill color, a stroke width specification of 4,0 user units; 
and a sUokc color of hkie (hexadecimal ^OOOOFF), 

Notice, incidentally, tliat llie graphic elements draw in the 
order in which they are specified in the source file. Since we 
sjx'cified the c:ircle first, it draws “behind" all other objeas. 

Next, we come to a <g></g> block. The grouping tags 
(that’s what stands for) enclose, in iliis case, two graphic 
objccLs: a rect and a text block. Before talking abi>ut the 
attributes given in the first <g> tag, let's quickly lotik at the 
graphic objects themselves. Tlie rectangle i.s given a style of 
"redfill'* using the class keyword (Notice that this .specification 
can occur at any place iaside the graphic object Here, its ai the 
beginning, before the gcoineiric: auribntes,) The remaining 
attributes specify tlie rccuingle's top-left-c'orner position and 
overall dimenskms. The text blot:k, on the other hand, is given 
the "whitewords" style (white fill color, so the words wilJ stand 
out against a red background) and a starring position, onscreen. 


of <20,30>. ITie text will be in 36-fKjini Timc‘s Bold, liecause 
that's what was specified in the “whitewords" style. 

Now let's go back to die opening <q> tag, Inside that tag, 
we assign a name identifier to the group^as-a-whole (“lopLayer") 
and specify some iramforms to operate on the group. First 
there’s a scaling transform, which has the effect of .scaling 
everything in the 'x’ dimension by 120%, wliilc the 'y’ dimeasion 
Is left at 100%. The translate operation moves the w^hole block 
70 units to the right and 40 units down. Finally, there is a rotate 
operation, which rotates the whole graphic ten degrees 
ckx-'kwise, (Note that the transforms are carried out in the order 
written.) We could also have specified a PostScripr-.style 6-digit 
matrix, with “matrix(1 0 0 1 0 0),” or whatever. (You wouldn’t 
normally use the identity matrixf) In this kind of matrix, tlic first 
and fourth numbers are scaling multipliers in x’ and ^y'; the fifth 
and .sixth numbers are translation specifiers- and die second and 
third numbers are used for shearing. (They represent the tangent 
of the shear angle for each axis, respeaively.) For rotation, one 
has to premultiply die first four numl>ers by the cosine, sine, 
negated sine, and cosine (respectively) of the destred rotation 
angle, Qinsult any l>£K>k on PostScript for more details. 

JavaScrifi 

One of the most exciting aspects of SVG is that it hands 
JavaScript programmers .something they’ve long been waiting 
for: a graphics engine with the power to poiduce scripted 
animations. Pveiy component of an SVG document fills a 
sp<n in a DOM parsetree, and every nook and cranny of the 
containment hierarchy is reachable via JavaScript That 
mean.s you can manipulate pretty much every aspect of an 
SVG image file via scripting. What’s more, your code can be 
located cither in ihc HTML page that the SVG image is 
embedded in, or in the SVG file it.sclf, or in an external file 
at a faraway UHL. 41ie choice is yours. 

It’s easier to show m example of st'ripted SVG than to 
explain how it works, so let’s go ahead and try our hands at a 
bit of SVG animation. Listing 2 shows the code from Listing 1, 
modified such that tht‘ circle object now' moves back and fortli 
horizontally, in sinusoidal fashion, at the rate of approximately 
one round trip every 7 seconds. 

Listmg 2: Ix>goAaitapl!^^ __ 

LogoAnimatcd.sv^g 

<?Kml vereion='‘L0" encoding,”"iso 8859 T?) 

(IDOCTYPE EVg FTM.TC " //W3C//DT13 SVG UAugust 1999//EN” 

"http ://ww.w3.org/Grii|]hi<is/SVG/SVC-19990812. dtd"> 

<svg J(nil:space="preserve" 
wicith""1000" beight^"1000" 

Qnlofld="sta rtup (event) **> 

<Etyle type""text/css") 

.redfllllfill:#FFOOOO;J 

,whitevo rds{font -family:Times Bold:font - 

sixe:36:nil:#FFFFF:l 

. clrclMSoleil (fill: #FFFF22: stroke -width: 4: stroke: (f DOOOFF: ] 
(/style) 

(circle id“"circ" cx""200" cy""l00** 
class="circDiiSolell" /> 
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i{i=**topLiiyer"* tratiBforjir’*scal e (I - 2 L) triinfJate(70 ^lO) 
rotate{10}"> 

<rect 01353="redfiIF 3f"l0'‘ y="0" widLh='*28B" bel£hT"'"40" /> 
<text class="whitewords" x="20*' y=’30" >Powered by 
SVG X/text > 

</g> 

<scrip t 1angua£C““Ja V3SC r1pt"> 

vat gDoc: 
var gCircr 
var gCount"^!: 

function startup(event) I 

gDoc * getSVGDorvinmnt{event »getTarget ()); 
gCi re " gDoc * getEl ejnentlyId C" cite'): 
aetIntetval("H{jginMoving[) */', 1000/20): 

1 

function getSVGDocufflent(node) f 
// given ;iny' ntJtk of ihr irct, ilib will 
//get lis tilt SV(iDiK.iimtnt node. But wc 
// must bt cartful: dtK' rkh n(Kkf*s owner null! 
lf( node,getNodfiTypeO F 9 ) //if not DCXiUMENT NODE- 
return node.getOwnerDocumentC}: 
return node; 

» 

function BeglnMovingO I 
gCount +* 0,044i 

gC1rc.serAttr1bute(‘ex', 

240+I20*Mfllb.sJn(gCount) ): 

1 

</£crlpt> 

</svg> 

'The first half of Listing 2 is l1il‘ sarric as Listing 1; We 
iiavc llic same grapliic obiccts, using the same C^S styles as 
l>efore. The only change to the first few lines of t'otie is in tlie 
first <svg> tag, where weVe inserted a call Lo an onload event 
handler, a custom function called startup(). If you look down 
about halfway through the code listing, yoiill see the start of 
our JavaScript block. As in HTMl,, st::ripLs in SVG must Ijc 
enclosed in <scripl></script> tags. Within those tags, w^eVe 
defined three functions and three global variables. The startupO 
function executes as soon as the page is loaded. It initialh'us 
twi> global variables, gDoc and gCirc, witli references lo the 
Document object (for the SVG document) and the ‘^circ” 
graphic element within the doaiment. The reference Lo gDtx: 
is oblained via a call to our getSVGDocument() function, which 
uses API calls to obtain the doc reference. 

To get a reference to the circle object, we call the 
Document object's getEIamentByIdO function, whicli lets us get 
an oliject reference by using tlie object's name identifier, (Recall 
that we named our circle 'circ', in anticipation of this nximent, ) 
The Final action that lakes place in the starlup() function 
is io call JavaScript's setlntervalO function, which gets our 
animation started, 'Itie first argument to this function is 
always a string literal that, w'hen evaluated, tells JavaScript 
what code to execute during repeated calls ro the animation. 
The second argument tells the interpreter how long to wait 
between calls to the first argument. This parameter sliould l>e 
in milliseconds. Since 1 wanted to try for 20 frames of 
animation per second (which is not overly optimistic for a 


small, simple animation such as this one), 1 gave a value of 
'1000/20' (one thousand milli.seconds divided l>y 20). 

The code that gees periodically executed by setlntervalO 
should be quick to execute. Accordingly, our BeginMovingO 
function is relatively short and to the point. In the first line, 
we incremenl a counter variable. In the second line, we call 
the circle object's setAttribute() function and reset the x' 
coordinate of the circle's center point to be 240, plus or minus 
120 times the sine of the counter variable. Thai means the 
circle will oscillate horizontally aliout x-240, moving a 
maximum of 120 user units in either direction. (Notice iliat I 
don't say “pixeis in either direc:tion/ because iPs possible the 
u.ser may zoom in or out on this animation while it’s running, 
in which case the total travel of the circle most certainly will 
not be pluS'Ormiinus 120 /)ixcls.} 

On my 250MHz G3 PowerMac with PrecisionView 17- 
inch monitor, the animation looks surprisingly smooth in 
Netscape 4.5, using the pre-release beta SVG plug-in dial Tve 
been fortunate entjugh lo be testing these last few months. 
(Free plug-ins will soon be available for all major brow'ser 
types, if they haven’t been annoimc:ed already.) Bear in 
mind, the circle is drawn behind the text and red rectangle. 
Yet the animation doesn't look “tlickery/' 

This IS, of course, a relatively trivial example of .scripted 
animation in SVG. With a little imagination, it's not hard to 
tliink of some pretty far-reaching u.ses for SVG animation. 
One could) for example, easily set up physics simulations, 
finife-element anaiy,se,s, or, in an extreme emergency, a 
"Hammer the monkey and win S20" banner ad, 

CONC:LlSSIt)N 

Web developers have been waiting years for D'fF 
features (like high-end typesetting, with font embedding) to 
arrive on the WWW, just as JavaScript programmers have 
been waiting aeons Lo be alile to draw vector graphics to the 
screen. With SVG, all these features — and more — are 
finally here, and well within the programming ability of most 
web-page developers. High-end graphic arts tools will soon 
be supporting SVG en masse^ but in my experience, you 
don’t really need anything more ihan a “bare bones” text 
editor (if you’ll pardon die expression) for all but the most 
challenging of SVG layouts. It’s quite feasible to write raw 
SVG by hand. 1 do it almost every day. 

To get the latest new's on SVG, be sure to visit 
<http://www.svgcentralxom> as well as the Adobe site 
<www,adobe.com>. And bear in mind that the more people who 
adopt SVG as a web authoring medium, the likelier it is tliat 
Apple will produce an SVG Image Importer for QuickTime 
(along with other forms of support for SVG). The close 
relationship between SVG, FDF, and I^xstScri(>t makes diis a 
potentially important Leclinology not only in the context of 
Quartz and OS X, but for web developers in general. As 1 like to 
say, Somefomg Very Gcxxl is aixmt io liappen. What you've just 
,seen here is only lire lieginning. ffil 
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By F.C. Kuecbnmin, Vancouver WA 


MacLarry 


An M68HC11 S-record 
dissecting kit in 
CodeWarrior Pascal 


iNTRODlJCnON 

S-iX’cx^ixl f'ilt‘s are u.setl to transtei' cocie 
from cicvelopmeni systems to PROM anti 
PPROM pr(3graiiunerw. This article discusses 
the iinplernentation Lind use of MacLarry. 
an S-retrortl tlisseaing program. Mnckmy 
allows you !o view the contenis of S- 
iect>rtls in ,several formats. 

WHAI IS AN S Record Fii.f? 

Programmers who are confined to 
the desktop world experience code 
inovcment in terms of disk file to 
memory and hack to disk. They are 
often unfamiliar with hex-format files 
that are used to transfer program code 
from a desktop development system to 
an liPROM (Erasable Prograiiimahle 
Read-Only Memory) or PROM 
prograninicr I'ot use in an emiredded 
controller, Common examples of 
embedded controllers include the 
jV16HilCM6 in a Jaz diive^ and the 
M6H,ixX'Series inhabiting Palm Pilot 
PDAs and anti-lock brake systems 
(ABScs) in General Melons cars, in each 
of these cases the progratn code 
proi)ahly spent some time in S^records. 


How do wc use one? 

In a typical instance you might lx: writing a BASICll 
program for a Mict-omint RTC-HCll stackable module to lx? 
used U> control a gate and barrier system at a fish hatchery. 
After the usual multiple-pass write-debug-modify-debug cycle 
you send an ^ESAVE" command to the RTC-HCll via the RS- 
232C serial fX)rt eonnedion (tisually the modem port on a Mac). 
The RTC-IfCJI, after a l)rief delay, churns out the program in 
its memory in the forjn of S-record.s. Using a terminal program 
you c:apture the records to a text file, clean up any garbage with 
an editor, and transfer tlie file to an EPROM pr{>grammer via a 
serial port. When the file has been written to a 27236 (32k-by- 
H) EPROM by the programmer you type an '‘AU'l'OS'r" 
command to the RTC-HCll, shut off its power, and replace the 
resident EPROM with the one you've just programmed. Restore 
the power anti the program autostarts and rtins. 

At another time you might .submit the MC68HC05b6 code 
for your smart toaster to Motorola in the form of an S-reeord 
file so that the proces.sons for your next production run can 
be masked with the code during manufacture. 


How IS MacLarry Useful? 

In the norma! course of embedded developnieni 
Maclarry is probnbfy unnecessary. You already have the 
assembler sotircet^ode. Btii svhat if old friend Murphy (of 
Muq)hy's Law lame) visits and destroys all copies of your 
source, leaving yoti watii only an S-record file of your cfxle? 

could be very useful in helping recover your source, 

Perl tups, after getting so involved in programming and 
testing that yoLi neglected to clearly label tlie files, you’re 
merely trying to determine which S-record file holds the most 
recent version, or a particular version, of your code. 

Or what if youTe just curious about some S-record files 
you found and downloaded from the net? Maclarry again 
comes to the rescue. 


RC. Kiieclunann is ;i programmer, hardwaa^ designer and consultant waih degrees frojTi the University of Illinois at Chicago 
and Clark Ct)llcge. His lavoriEO progniinming language is Pascal and his favorite progiamming utility is a large mug t)r kaffee 
mocha. He am Ix’ reached :il fk@aone.com. 
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What does an S-record k)ok like? 

*rhc S-recf>r(J format originated at Moumjla and is 
commonly used with code lor processors made by that 
company, including the extremely popular MCGHMCOS used 
in cellular phones and fmgers, and the M68HC11 series. S- 
records arc similar in concept to the more common Intel hex 
foniKU with a few important differences in detail. An S-reenrd 
line consisi.s of a tw^o-churat1CT header, a two-character hex 
bytecfHinl that gives the numlw of bytes in the record, a 
two-byte hex address, hytecxnint minus three hex bytes of 
code, and a one's complement hex checksum. The S-record 
file.s rhai Afaclarry deals with have ‘"ST’ hc^aders on all lines 
but the last, which has an ■'S9'* header and no significant 
content, U’he components of a line with an “SF header might 
look like Figure 1. 




1 ■ 


/; 


/ 


Ctisckwm 

i 


SI 13 0000 CJ 210 BC 30 e 01 C 32101 C 3340 lC 33301 C 3 \m 


S-rccorU Format 


Figure L S-record formai. 


“Sr is the header. 11ie next two digits (13) indicate in 
hex the number of liytes to follow in the line, including a 
four-digit address and two-digit checksum. The “0000’' is the 
address and is followed by 10 (hex, 16 decimal) bytes of data 
and the “BF'* checksum. 

MacLarry TiiL Dissector 

The CodeWarrior Pascal program MacLarr}f can he 
used to tlis.seci M68HC11 S-records in order to recreate 
assemliler sourcecode. MacLany dissects 68HC11 S-records 
three ways: 


• Aseiilication - isolates printable ASCII characters (range 
32 * 126 ), 

• Disassembly into mnemonics with address and data fields. 

• Disassenibty without address and data fields for ready 
conversion to assembler sourcecode. 


Asenflealion or dumpster? 

What is “asciificalion"? This method of dissecting S- 
record files prints characters in the ASCII range 52-126 f>eside 
the address and liex data, replacing characters ouiside that 
range with dots. This sort of out pur is commonly called a 
“hex dump" when derived fnJiit a binary file. But what is it 
if you start with a liex file to begin with? Qm you hex dumj) 
a hex file? “Dumpster" might be a more descrijilive name 


than “asciifier". Whatever it's called, it simplifies loc'ating 
embedded text strings and command tables in the target Pile. 

The output files 

A MacLarry dissection creates three files, one eacli 
with I he extensions “asc", "dus" and “sre" appended to the 
(original filename minus the usual “SIT extension. Thus if 
the S-record filename Is JudithWhatley,S19, the outpul files 
will be JudithWhatley.asc. JudithWhatley^dis and 
JudkhWhatley.src. 


Sample output 

Listing la show's the asciiI'icalion of pans of the file 
BASIC115.S19, containing version 1.13 of BASICII BASiCll 
is a Freeware integer BASIC interpreter for the Mf>8HClL 
Versions of this BASIC arc distribnied i>y companies such as 
New Micros Inc. and MkroMiat Inc with some of their 
M68HC11-based sLackal)te control computers. Generic versions 
that aren’t modified specifically for a given nianufactureris 
lx>ards are also freely available via the internet. Some LlRLs can 
be found at the end of this article, llie listing shows tlie 
identity text and copyright notice. 


Listing la, 

Asclfylng basin,sl9 
Start 19:38:41 

FinlRh 19:39:08 


JiOOO 0000 
EOlO 0010 
E020 0020 
E030 OOJO 
E040 0040 
E050 0050 
E060 0060 
E07Q 0070 
K080 0080 
EU90 0090 
EOAO OOAO 


7EED3aaD£GD6B66tM)8eib52fi03iJDl''l Ifi 
BDEOe08EDF?F0E^iF5FDD3ADD3fim41BD 
BOA37H>aJ97FO0lS7FOOlOBDE0F4BDE{J 
B3BOEO53finEKflFLA83Q0OO26I)6DEOEDF 
2FEDE116/0001976CA20D7DE2F6F00DF 
0E20C0BDE38Gai207605BDFA9520F439 
CEE0667EE10BOiX)A0imA424153494531 
3l2Q76312E3D30IKJA436t70?9726%7 
68742031393335203139383620627900 
OA476F72646F6H20446F7567686D6i68 
ODOAODCEEOA97EE10BODOA5245414459 







_A. 

.4, ../q. 


. A.,., .9 

1 vl.13..Copyrig 
ht 1985,1986 by. 
.Gordon Doughavan 
-....READY 


Listing lb reveals a table of BASICII command.s, 
which are presumably used in tokenizing input. 


Listing lb. 


S200 0200 
E210 0210 
R270 0220 
R230 0230 
8240 0240 
E250 0250 
E260 0260 
E270 0270 
£280 0280 
£290 0290 
R2A0 02AO 
F2B0 02BO 
8200 02CO 
E2D0 0200 
E2E0 a2£0 
E2F0 02F0 
E300 0300 
E3i0 0310 
£320 0320 
E330 0330 


81342607867A8nE3A020B3eiOD270586 
O27EEA4£B6/DBDE3AOrK:O283DEO0CEDE 
00E7O23944415441QO0CE3BC4C4554OQ 
0l£3]X:524S4144gtJUDliAOK:)24553544F 
5245000EE3BB474F535542000L'E3B247 
4F544F0CUl£3B24F4E54494D45G02bKg 
894F4E49525ia026E8894F4£50414343 
D028E8A94F4FXKinE83B52455455524E 
0014E3BB494600rjF3BD494E50555400 
] 6E9F&5052494K540003E98E.3F0003E9 
SH464F520004E9264K4538540005E981 
53544F500017E3fliJ454K44574800lAF.3 
BB454E440013E3BE52454LK)OOAE3BO54 
524F4EOO0GE3BB54524F4646OOO/K3liB 
^/48494C4S0019EA4L504F4B450003E7 
B344494J)0OO9F.AnF.4545S000lBE7CC5O 
4F525441001CE308504 £5254^12001DE3 
D8504F525443001EK3I18504F52.544400 
IFE3D3494F425954450023FA3954494I3 
450024EA4952455449002/E3ftB504l43 


.: 4.. z... .,, \ . 

.-MA ... 

,..9DATA,...m, 
...READ....RESTO 
RE....G0SUB..,.G 
QfTO.-. .tFTTTHE.tt. 
.0NIRa.i,,0NPACC 
.0N.,,:RET(JRN 
..,.lF,...lNFU'r. 
...pRiirr....?,.. 

.F0R,..6NEXT..., 

SinP...,ENDWH.,, 

RON....TROFF..., 
WIULK.. ,AP0KE., , 

.DIM_EKF_P 

0RTA.,..P0RTB... 
.PORTC..,,PORTO. 
,..IHBYTEJ.9T1H 
E.S.IRETI.\ .PAC 
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The BUFFALO monitor is a freeware M68HC11 monitor 
BUFFALO is an acronym for Bit User Fast Friendly Aid to 
Li>^ica! Operation. 

The partial asciification of the Buffalo monitor, is shown 
in Listing 2. It looks like a command table starting about 
$E543, followed by the Buffalo sign-on string at $E6lF, 
followed by error messages. 


Listing 2. 


B540 D540 
Em 0550 
E560 0560 
E570 0570 
E5e0 O5S0 
E590 05% 
E5A0 05A0 
E5B0 05BO 
E5C0 0500 
E5D0 05D0 
E5E0 05E0 
E5F0 05F0 
£600 0600 
£610 0610 
E6a0 0620 
E630 0610 
£640 0640 
£650 0650 
E660 0660 
E670 0670 
£680 0680 
E690 0690 
E6A0 06A0 
E6B0 06B0 
E6C0 06C0 
E6D0 06D0 


BE1905415151454DF2F905425245414B 
E6D00442554C4BE7980742554C4B414C 
4CE79D0443414C4CE8A30444554D50E7 
A60446494CACE31B02474FE8FB04484S 
4C 5 0M7 60448 4F5 3 5 4EEE4044C4F4144 
EF82064D454D4F5259F08l04^iD4F5645 
F1340750524F43454544E8E908524547 
4933544552F1C506S3544F504154E9D1 
0554524l4345E9eC06564552494659EF 
7A011FEA760SSS424F4F54FDB1034153 
4DF2F9024246ES3804434F5059ni405 
45524J5345E7 98024D44E7A6034D4DF0 
8i025244FlC502524DFlC504524S4144 
F13402544DEEE40454455354FE29FF42 
554646414C4f20332£32202S696E7429 
202B2042697420557365722046617374 
20467269656£646C7920416%420746F 
204C6F676963616C2O4F7O6572617469 
6F6E04576a61743F04546F6F204C6F6E 
670446756CeC044F7D2D2004726F6D2D 
04436F6D6D616E643F04426164206172 
67736C656E74044E6F206S6F73742070 
6F72742061766L696C6i626C6504646F 
6E6504636865636B73756D206572726F 
72046S72726F72206J64647220047265 
636569766572206572726F7204BDE2FA 


.9.ASSEM*,.BR£AK 
,..BUIK,..BULKAL 
L*..CAU,,.DtlMP. 
,*FILL.;.G0..*KH 
LF.v.HOST...LOAD 
MEMORY..^HOVE 
*4,PROCEED,*,REG 
ISTER., ,ST0PAT.. 
.TRACE*..VERIFY* 
I.7.V.XB0OT*..AS 
M*..BF.:,C0PY.4* 
ERASE... 

*.RD**.RM..*REAI) 
.4*TM.**TEST.),B 
DFPAtO 3*2 iinty 
Bit Us^t: Fast 
Friendly Aid to 
Logical Operati 
on*What?*TaQ Lon 
g*Full.0p- .rofli 
*CQn«nand?.Rad at 
giment.No host p 
ort available.do 
□e*checksum erro 
r,error addr *re 
oeiver error..** 


The disassembler 

Disa.sscinbly is the conversion of macliinc insiructitins into 
their assembly language equivalents* An output line produced 
by the MiacLarry disasseml^ler consists of an unmodified S- 
record address, then the sum of the nomlKT of bytes fetched and 
the EPROM base address (which defaults to Eero)* One (or two 
if the byte is $18, SIA or $CD) byids) of opcode precedes one 
or more bytes of operand if present (die inherent addressing 
mode has no otx.rand). The mnemonic then is followed by the 
hex operand if present.. A typical disassembled line looks 
.somediing like Figure 2 


S^rec EPROM Or>ced<r 

\ i 

0030 E030 18 CE EE 3A Idy #$eb3a 

A/ A 


Opcode 
Byte* 


Operorid 
By lei 


Operand 


listing 3 shows the dLsa.ssembly of the lieginning of version 
1.13 of BASIC11*S19. The added comments indicate the Reset 
entry point accressed via the address stored at $FFFE-$FFFF, 


Listing 3* 


Dlsass '— has113*si9 
EPROM Addr SOOOQ 


Offset — 

0 bytes 




Start 

19:39:09 




Finish 

19:39:20 




EOOO ODDO 

7E ED 30 


$ED30 


RCI03 0003 

BD EC D6 

jsr 

SECD6 


£006 0006 

B6 60 oa 

Idaa 

$6008 


£009 0009 

81 55 


#S55 


EOOB OOOB 

26 03 

bne 

$03 


EOOD OOOD 

m F] 16 

jar 

SFU6 


EOlO 0010 

BO EO 60 

jsr 

$E060 


E0I3 00L3 

8E DF FF 

Ids 

#SDFFF 


£016 0016 

OE 

cli 



E017 0017 

4F 

clra 



E018 OOIB 

5F 

clrb 



E019 0019 

DO 3A 

std 

$3A 


EOiB DOIE 

DO 3F 

std 

S3F 


EOID OOID 

DO 41 

std 

S41 


EOIF OOIF 

BD HO A3 

jer 

$E0A3 


E022 0022 

7F 00 19 

clr 

$0019 


E025 0025 

7F 00 18 

clr 

$0018 


E028 0028 

7F 00 10 

clr 

$0010 


£020 002B 

£D EO F4 

jsr 

$E0F4 


ED27 0D27 

97 IG 

staa 

$IC 


ED29 0D29 

B7 AO 00 

stai 

$AOOO 


ED2C 0D2C 

7F GO 37 

clr 

S0037 


ED2F 0n2F 

39 

rts 



ED30 OD30 

86 93 

Idaa 

#$93 ; reset 

vector 




1 points 

here 

ED32 0D32 

B7 10 39 

staa 

$1039 


ED35 0D35 

86 03 

1 daa 

#S03 


ED37 OD37 

B7 10 24 

staa 

$1024 


ED3A 0D3A 

8E DF FF 

Ids 

(f$DFFF 


ED3D 0030 

GE 00 C4 

Idx 

#$00C'i 


ED40 0D40 

18 CE ED C2 

Idy 

IfSEO 


£U44 0D44 

C6 14 

Idh 

iHSIA 


ED46 0046 

06 7E 

Idaa 

#$7E 


£048 0D48 

A7 00 

siaa 

$00.X 


ED4A 0D4A 

08 

inx 



ED4B 0D4B 

lA EF 00 

sty 

$00. X 


ED4E 0D4E 

08 

Inx 



ED4F 004F 

08 

inx 



ED50 0D50 

5A 

deeb 



E051 0D51 

26 F5 

bne 

SF$ 


£053 0D53 

97 9E 

staa 

$9E 


ED55 0055 

97 A1 

sLaa 

$At 


ED57 0D57 

CC EC 79 

tdd 

#$E(;/9 


ED5A 0D5A 

DD 9F 

std 

$9F 


ED5C 0D5C 

CC EG 6E 

Idd 

#$EC6E 


EDSF 0D5F 

DD A2 

std 

$A2 


ED61 0D61 

CE 00 F7 

Idx 

tf$00F7 


E064 0D64 

CC ED 30 

Idd 

#$EB30 


ED67 0D67 

HD 01 

fltd 

$01, X 


ED69 0D69 

ED 04 

std 

$04. X 


EDSB 0D6B 

ED 07 

std 

$0/.x 


EB6D 0D6D 

CE 00 A4 

Idx 

#$OOA4 


ED70 0D70 

C6 20 

Idb 

jll$20 


ED72 0072 

6F 00 

clr 

$00. X 


ED74 0D74 

08 

inx 



ED75 0D75 

5A 

deeb 




Hgure 2. Mudxirry sample output. 
LLstings 3 anti 4 provide examples* 


In listing 4. you can see the disassembly of the beginning 
of version 3 2 of the Buffalo monitor. The comments highlight 
the $E00O entry point. 
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Listing* 4. 


Disass “ 

bu02,sl9 



EPROM Addr 

$0000 



Offset — 

0 bytes 



Start 

19i40;05 



Finish 

19j40:16 



EQOO 0000 

CE 10 OA 

Idx 

#$100A preset vector $FFFE-$FFFF 

EOOl 0Q03 

IF OO 01 03 

brclr $Q0,x $01 $03 ; points tn SEOOO 

H007 000/ 

m B6 00 

jmp 

$B600 rtest pin 1 at addr $IOOA 

EOOA OOOA 

86 93 

Ides 

#$93 : [port Ej; branch to SEOOA 

EOOC OOOC 

B7 10 39 

staa 

$1039 : if pin 1 low, else Jiup to 

EOOF OOOF 

afi 00 

Ida a 

#$00 :5ll byte reset rontlne at 

EGll 0011 

B7 10 24 

staa 

S1024 ;SB600 in internal EEPKOH 

m\k 00 J A 

66 00 

Idaa 

ffsoo 

E01& 0016 

B7 10 35 

ST.aa 

$1035 

£013 0019 

8E 00 65 

Ids 

#$0065 

EOlC OOlC 

BD £3 4B 

jsr 

$E34B 

EOIF ODIF 

CE 00 47 

Idx 

#$004/ 


Offset and address options 

Tlic I wo user options - offset and EPROM base address 
- affect disassembly. Since most real-world code contains 
embedded (km, tables, and other things that aren't opcodes 
and operands, it is useful to be able to vary the point at 
which disassembly begins, "^throwing away** a user-specified 
number of data bytes from the beginning of the S-rccord file. 
It is ffe{|uenily necessary to combine pieces from several 
disassemblies with different offsets to accurately reconstruct 
the skeleton of the source code. 


In addition, record addresses may or may not 
correspond to die actual EPROM addresses where the code 
runs. For example, in the case of the BASIC11E9 distributed 
by New Micros. S-record addresses tx:cupy the range $0000- 
$1FFF, yet the code is programmed into an EPROM that is 
addressed at SE0Q0-$FFFF (2764 Bk-by-8 size). Address 
references are easiest to assess when the ctirrecied addresses 
are provided by the disassembler The EPROM address also 
affects ihc asdification listing, showing the location of text in 
processor memo^}^ MacLarry^s menu allows the user to 
vary the offset in the range 0-9 bytes and the EPROM base 
address in the range SOOOO^SOOOO in $1000 .steps. 

In listings l-A in this article, the S-record addresses run 
from $EOOO through $FFFF and the EPROM address option is 
left at the zero defaull, 

Pr<x;r.4M Strixti^re 

MacLarryf makes three separate passes through the S- 
record file, creating first the ""asc" file, followed by the “dis”, and 
concluding with the “sre"’ file. In all ca.ses output is initially 
written to a temporary file, then copied to the final output file 
after dissection is complete. In pseudocode, minus the folderol 
and simplified, the main program lofip kx>ks like Lliis: 

for ti:- 1 to 3 
begin 

open e-rec file 
fipsn trap file 
case n of 
1: 


Cisco 

Sun 

HP 

Compaq 

Apple 



Commit this to "Memory!" 


SGI 

Dell 

IBM 

Gateway 

And many 
more... 


Rocky Mountain Ram is a manufacturer of the highest quality computer memory, 
UpCTades for aU major brands of Routers, PC's, Apple, Workstations, Servers, Laptops 
ana Printers. Rocky Mountain Ram maintains extensive inventory for fast service and 
factory direct pricing. All design, acquisition and manufacturing are in-house. 

Rocky Mountain Ram has over 60 years of combined experience in the computer memory 
industry, and specializes in Government, Internet and backbone providers, University and 
Fortune 500 companies. Rocky Mountain Ram is dedicated to meeting our customers memory 
requirements in a responsive, knowledgeable, and supportive manner. 


Visit our website at www.ram-it.com (800) 543-0932 Fax (303) 413-8255 








ascllfy 

2 : 

3: 

sourcecode 

end: 

close E'rec file 
copy tJQp file to final file 
end: 

'rhe asdifier simply reads each line from the input file, 
strips out the header and byte count, then formats an output 
line consisting of address, corrected address, hex data, and 
the printable ASCII characters in the data; diaracicrs outside 
the printable ASCII range ^5^32^ 126 are each represented by 
a dot C X 

The disassenibler structure is more a)mp]ex but logical. 
After opening the input and output files, ilie program fciclies 
and coutiLs but otherwise ignores the number of bytes 
specified in the offset parameter. In pseudocode, you might 
do it like this: 

count * * 0 

while (not eof) and Ecount < offset) 
fetch data byte 
increment count 
wend 


The main kx>p follows: 

while (not eof) and (not error) 
fetch data byte 

tf not making asscmblor eourcecode 
send S record addreeH to outfile 
seiiid EPKOM address to outfile 
end if 

process data byte as opcode 
wend 


Thf Main Ffij: 

Listings 3a and 5b show tlie contents of the main 
program file, MacLarrvtp . After calling the Initialize 
procedure to inil the itKilbox, window, global variables and 
such, the program calls the DoMain procedure in Listing 
3b, which serves as the program's manager. When il returns 
from DoMain it calls the procedure Clean Dp Mess, wh(>se 
function should be obvitjus. lx,Tore terminating. 

Listing 3*a 


M:id.;irry 

HacLarry 

A Motorola M&8HC1J S-rfiCord njfinerTer 

F.C* Kiterhinann 

199fl-9 

•) 

Program MacLarry: 

UECS 

GXobala *Inits,Wise * FileStuff * EventStuff,TineStu f f, 
Disassembler, Sotircer .DoAski; 


begin 

Initialize: 

InitRsgionHdl: 

DoMain: 

KlllRegiDnHdl; 

Cl eanlJpMess; 
end. 


DoMain first inilialize.s some local variables liefore 
entering two rtested repeat loops. The inner loop executes, 
continually checking events and updating the lime, offset 
and EPROM address displays, until the goFlag is .set by 
pushing the “Go'' button or the dooeFlag is set by pushing 
the “Quit” l>yUon. If the “Quit" button was pushed, the Leave 
instruction exits the outer loop and the procedure is exited 
thereafter. If the ""Go" button was pushed a file selection 
window appears displaying rhe '1'F,X'r' files in the current 
directory. If no seiection is made, tlie outer loop is exited. If 
a selection is made, a for loop that serves as dispatcher 
executes three times, opening files and calling rhe asciifter, 
dfsasscrubier and sourcer code in succession* The proper 
output file ts created during each iteration and the header, 
start and finish times written to the output file before the 
temporary file conlenis are adder!. In the case of the “dis” 
and “sre'" files, the EPROM address and offset values arc also 
written to the output file* After completion of the for loop a 
repeal loop executes until either the “Go" button is pushed 
to dissect another file (or perhaps the same file with a 
different offset value) or the “Quit" button is pushed to exit* 

Listing 5b. 


DoMain 

proiCTlure DoMain: 
var 

selectElag,eofFlag*errFlaR,doneFlag. 

goFlag,flag:boolean: 
fileMaiHe, textLine .outLine, outLioel, 

outUnfi?..S.5! ,S?:Str25S: 
nowTima, e ta r i TI me, st a r i T J mQ2 , cjidTimtJ: iJat etlmcRei: : 
index,offset.n:Integer: 
opromAddr:word; 
tiDwSec s, startSecs: longint: 
const 

cDoneStr.'stringr'DoTie! *: 

begin 

index:“I: 
n:”0; 

^iLarLSec$!Ki: 

ClearWincIow: 

ShowWlndovEggMankWitidow); 
ecrFlag:-FALSE: 
doneFlag:=FALSE: 
gaFlagi-FALSE: 

oittLIncj^ggcNullString: 
ontLinel ;=^ggcNullString: 
outLine2:=ggcMullString: 

repeat 

eprotoAddr: =ggwEproiiiAdd r: 
offset;=ggThrowAway: 

SetCont rolTltlctggGoHut, lordtdl. : 

repea t 

GetPateTime(nowSeesJ: 
if novSecaOstartSece then 
begin 

GetTlme(startTime): 


76 


MacUkhy 


MacTECH • FiaiRUARY 2000 









Tijfle2Strina(stattTiJBe.S2): 

Updct t eRec t Tggc HeginTime. S2}; 

St a rt Se c 3:=nowSec s : 
end: 

HandleEventCdoneFlag^goFlag); 

If off set OggThrov Away tl^en 
begin 

offset :=ggThrowAi#ay: 

UpdaloRect(ggeOf fsetRecl♦ggcNullStfIng]; 
end: 

if epromAddrOggwEproinAddr then 
begin 

eproisAMr: “ggwEpromAddr: 

UpdateRect (ggtEpromRGct .ggcNiiilString): 
end: 

yntil goFlag or doneFlag: 
if dorieFliig then 
leave: 

SetCont toiXitle{ggGoButtonHdi.^ Pause'): 

Select File (salectFlaR^fileNanie}: 

ClearWindov; 

if not selectFlag then 
1 cave: 

GetTtine tstattTime): 

Tiae 2 St r in g {st a rtTi me * S2): 
UpdateRectTggcBeginTiai 0 ,S 2 J: 

BaIeToSeconds (start Time, startSecs): 

outUnel :Hrford2BejiStr{ggvEprfiinAddr): 

□utLinei :*concaT< ■ EPROM Addr SV,{>utIJ.nel) ; 

N umfToS t r ing t g gTh r owAva y, outLi nG2); 

outlined:=concHt{*Offset — ’*outLine2/ bytes*): 

for inde«i-^l tc 3 do 

begin 

TnitRinBatLin: 

errFlag:-FALSR: 

Opens rec File (flleName, erri-lag); 
if errFlag then 
leave: 

[output goes first to a temporary filel 
(that 1 b copied to the final out filel 
(with start and end times both at the! 
Ibeglnoingl 

OpeiiTupfc'ilcWrile (errFlag): 
if errFlag then 
leave: 

GetTioie (startTime?); 
Time2String(BtartTiine2,Sl); 
cane indesc of 
ggcMakoAsk t: 
begin 

S:**Ascilying '+flleNaiiio: 

AscifyFlle(startSecs.doneFlag): 
UpdateRect(ggcAsky.cBoneStr): 
end: 

ggcMakeBla: 

begin 

S:“*fUBass '+fnoNamo: 

UisDatFile(startSees^doneFlag): 
end: 

ggcHakeDat: 
begin 

S:*'Soitrc - ' i^fileNama: 

SourceBatFiIe Csta rtSecs * donsFlag): 
end: 

end; 

CetTime(endTime): 

Tiiie2Strlng(endTime*S2): 
CioseSrecFile(errFlag): 

Clo&eTmpFile(errFIag): 
if errFlag then 
leave: 


lopcn Letup file for InpyLl 
OpenTmpFileioad(errFlag): 

(create 6 open destination file) 

OpenOutFi1e(fileName-index.errF1ag.TRUE): 
if errFiag then 
leave: 

(asc, dis or arc line) 
VrlteTfi0ut7ile(S*errFlag); 

fEPROM addr & offact to diaaBa h arc files) 
if i rid eji>ggc Make Ask i then 

begin 

WriteToOutFiletoutLinel,errFlag): 
WriteTo0utFil6{outUne2.errFlag): 
end; 

if not errFlag than 
begin 

(bag & fin times) 

WriteToOutFiie t * Start *+Sl,errFiag): 

WtlteToOutFile(VFinish *+S2.errFiag): 

(send a few blank lines) 
for n:=l to 3 do 

WriteToOutFiie(ggcNul1stringt ar rFlag): 
GOfFlag:“FALSE: 

Ircad imp. write finalI 
while not (eofFlag or errFlag) do 

begin 

ReadFromTmpFile(S.eofFlag.errFlag): 

WrIteToOutFile(S.a r rF1a g): 
end: 

tshoot a few blanks) 
for n:^l to 3 do 

WriteToOulFi1e(ggcNuilSt ring * er rFlag); 

CloseTtttpFlle(errFlag): 

(erase tmp file for re-use] 

ScratchTrapFile(errFlag): 

Cl 0 E eOutFile(ind ex,e r rF1ag * f1a g): 
RraflnErrMesn: 
end: 

end: I for) 

UpdateS19Rect tggcNailStrliig.2): 
goFiagi-FALSE: 

SetContrQlTitle(ggGoButtonHdl.*Run*): 
repeat 

Ha nd1eEvent(done?1a g * goFIa g): 
until goFlag or ddnoFlag or errFlag: 

ErasoErrMoss: 

until doneFlag or ertFlug: 


Creating assembler sourcecode 

The asciifier, disassembler and sourcer rnutines all fetch 
lines one-ai-a-iime from (he mpui file and disseeL Lliem in the 
appropriate manner, blessing the output files with the results. 
The following disassembly code listings are for creation 
of assembler source files C^'src'' filename extension) with a 
space in the label field left of the innemonicL The code fur 
‘*dis’' files is similar, but the output lines contain address and 
data fields left of the mnemonic. 

Ft)r disassemblies a pair of hex digits is chopped from 
the data segment of the s-record and converted to an 
unsigned byie integer value. Ii is then passed (o a 
ProcessOpCode prL>cedure .shown in Listing 6. There, die 
opcode is tested against the values held in sets of byte 
constants whose membership is arranged according to 
addressing mode. 
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• cPcisiRyteSet membership indicates we’ve got the first byte of 
a iwo-byie opcode and need to fetch anoilter byte it> find t>ut 
what to do. Postbyte instructions operate on the Y-index 
register and D-accumulatoc 

• cRelSet instnjaions are relative branches in the range - 
128,,+127 addresses from the current address and require 
feiching a single operand byte holding the offset. 

• clnhSei opcrodes consist of complete instructions requiring 
no operands, 

• cfndxSet opcodes use the X^index register and need a 
variable number of operand bytes. 

• cImmSet opcodes have data operands rather than addresses. 

• cExtSet ofxodes use extended addressing with two byte 
operands. 

• cDirSet o|x:odcs use direa addressing with single byte 
operands. 


Listing 6. 


Proc'cssOpCodc 

procedure ProcossOpCode(opcodetbyte; 


var errFlag.eDfFlag:bcM>lean}: 

const 

cPostByteSet 

:g8tByteSet=l$18.$la.$c<JJ; 

cRelSet 

;gRtByteSet=|$20..$2f.$8d]; 

cInhSet 

:gRtB5rteSet=f$OO..SOf.$10.$lt,S16, 

clndxSet 

Sn.SlR.Slb.SBO-.SIf, 

$40.$43.$44,$46..$4a, 

$4c.$4d.$4f.$S0.$33.$S4. 

$!i6..$ia.$4c.$!id.$4{, 

S8f.$cfl; 

:ggtByteSet"ISlc..SIf,$60.$63,$64. 

cImnSet 

$66..$6a.$6e..$6f. 
$a0..$af.$e0..$efl: 
:ggt.ByteSct=r$80. .$86, $83. .$8e. 

cExtSet 

$Se.$cQ..$c6. 

$c8. .$cc.$c<>j: 
:ggtByleScl=[$I5.$70,$73.$74. 

cDlrSet 

$/6..$7a.$7c..$?f. 

$ad.Sb0..$bf.$f0..${f|: 

: ggtByteSet- l$12..$14.$90..$9f.$(i0..$dfj: 


begin 

if opcode in cPoetByteSet then 

ProceRflPoKtRytn(opcode,firrFlag.enfFlag) 

it opcode in clnhSet then 
ProcessltihErent (opcade, ecrFlag, eofFiag) 

else if opcode in clndxSet then 

FrocessIndexX(opcode.errFlag,eofFlag) 

else if opcode in cPelSot then 

ProcessPelalive(opcode,e r r Flag,corFla^) 

else if opcode in cInmtSet then 

Proces sImmediat e{opcode,e rrFiag,eofFlag) 

else if opcode in cExtSet then 
ProcessEirt (opcode,errFlag.eofFlag) 


else If opcode in cHlrSei then 

ProcessDlreel(opcode.errFlag,co fFlag) 
else 

ProcessNotInSets{opcode,etrFiag )i 

end; 


PrtH:efising inherently 

Converting inherent addressing made insirucUims is 
simplest in that the operand is inherent in the opcode and need 
not be fetched separately, 'llie Processinherent procedure is 
.shown in listing 7, Using die opeexie as the selector in a case 
statement, the mnemonic is assigned to the string variable s. 
Variable s is then concatenated with the string variable sreStr, 
which liolds a space, and sent to the output file. 

Usting 7. 


ProcessioherenT 

procedure Processlnheraot(opcode:byte; 

var err Flag.eofFlag:boolean): 
var 

s,£rcStr;sir2S5; 

begin 

SrcStr:=ggcSpace: 
case opcode of 
$00 : 

s:"*teEt *: 

$01 : 

s;“'nop': 

$02 : 

$01 r 

s;“'fdlv'; 


$58 : 

s;^'aslb'; 

$59 : 

s;=*roib*; 

S5s : 

s:”*decb*; 

$5c ; 

s:='ineb"i 
$5d : 

s:="tstb': 

$5f ; 

s;='cirb'; 

$Sf ; 

s:=■xgdx'; 

$cf : 

R: = ’si:op*: 

end; [case] 

srcStr:-concat(sreStr.s); 
PutStringtsrcStr.errFlag}: 
end; 


Other address modes 

Addressing rncxies other than inherent rec|uire one, two or 
tiiree byte operands to be feiclied from the input text and 
anached to tlie output string. Ihe direct address mode offers a 
simple illustration of how this can Jx? done. 
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guide from the editors of Macworld magazine; vvith MacBuy.com youTL know... 


...which products to buy. And which to avoid. 

The best deals on the Web, And where to find them. 
How much ft costs. And how much ifs worth. 

www.macbuy.com 

The Macworld Buyer's Guide 


As Easy as l-Z-3 
Whether searching for a 

product review or finding the Pick 
Of The Day, it's easy with 
MacBuy.com's clean user interface 
and intiiitive navigation. 

Convenience and Slshiel 

The latest and lowest prices from 
leading Mac resellers. Plus, 
convenient links to their sites so 
you can purchase the product you 
want instantly! MacBuycom tells 
you how to shop smart. 

Powerful and Easy-.., 
to-use search engine. You can 
search by product or vendor name, 
or use the Power Search button to 
search by multiple cnteiia, such 
as rating and price. 

Support from Apple 
Literally. Built with Apples 
WebObjects, MacBuy.com is solid 
as.,,well a rock. 

from the pubijshefs of Macwofid magoim 


MacBuyf 



com 

Get ft right 











































































Direct mode 

The procedure ProcessDirect, in listing 8, defines two 
sets of coasuints that hold the values of the opcodes tliai require 
more than one of>enjnd byte* 

Listing 8. 

ProccssUirtct 


Tile o|Xudc Ls used as die selector in a case statement to 
assign the proper rrmemonic to a string variable; most of the 
case statement is omitted from the listing io enhance clarity. 
Next die first Ofxxand byte Ls feiched from the input stiing and 
joined to the output siring* Additional bytes are fetched for the 
memixrs of ihe two and three byte seLs and appended. The 
completed line is tlicn sent to output. 


prodftdure PracessCirect(iipcodei^yte: 

var errFlag,eofFlag'boolean); 

var 

s»operands L r,sreSt r:st r25 5; 
gpe[rand:by Le: 
bEdHexFlag:bool€eLri: 
const 


cTwoByteOpatSet 

;gatByteSet=[$l4j : 

cTh t eeB yteO pe r S et 

:RgtB^eSet^lSl2 ,$13] ; 

begin 


badHexFlag;»FAhSR; 


sreStr:"ggcSpace: 


case opcode of 

finst XX1 

$12: 

(braet dd mni xxl 

s;“'braet': 


$13: 

tbrclr dd m xxJ 

ar=*brclr'; 


$14: 

ibset dd mral 

3:**bsot*; 



$de : 

8:='ld>t': 

Seif : 
aj^'srx* ^ 

I case I 


Indexed instruclions 

Index register insiruciions are somewhat more compliaited 
in fomiatting in dmt they often require inclusion of an “x” or “y" 
in the output line. Instruciions for the ''X'" register are handled 
by the code in Listing 9 


Listing 9- 


ProccsslndexX 


procedure ProcefisIndexX(npeode:byte; 

var errFlaR.eofFlafi^bgglean): 

vnr 

s * operandSt r * sreSt r ^ bt r25S t 
badllcKFlag: bool ean; 
operand:byte: 
const 

cTwoByteSet :ggtByteSet=l$le.$ldJ: 

cTh r eeBy teSet : ggt Byt aSet* t $1e.$1f]: 

begin 

badHe>jFlaE:=FArpSE: 
srcSlr;=ggcSpace: 
case opcode of 


srcStr:-eoncat(©rcStjr.e): 

FetchByte(a,er rFiag.eotFiag): 
if not J!exStr2Iyte(s*operand) then 
badHexFlag:-TRllE 
nine 

begin 

operandStr:=coticat(*$* ,s): 
if (opcode in cTwoByteOperSer) or 

(opcode in cTbreeByteOperSerJ then 


begin 

Fet chflyte(s,e r rFlag,eo fFIag): 
tf not HexStr?.Byte(a^aperand) then 
badHcxFlagi^UE 
else 

begin 

operandStr **"concat(operandStE. 

ggcSpate. *S\£) s 
if opcode in cThreeByteOperSet then 
hegtn 

FoLchByli'(a*errFlag*oorFlag): 
il noL HexSir2Byie(s♦Operand) then 
b9dHexFlag:='rR0E 
else 

OperandStr:=concat(operand St 

ggcSpace, : 

end; 

end; 

end; 

end: 

if not badHexFlag then 

sreStt :“coficatTfircStr. ggcSpace^ operandStr) 
else 

s f c S t r: “c nncat (a re St r. ggcSpac e, n pe ra nd St r, 

ggcSpace,s»g|cSpace** - Invalid hex byte!'): 
FuLSltlngCsrcSU^DrrFlag); 


$lc; 

1 bast (ind.x) ddl 

s;“'bset *; 


$ld: 

Ibclr (ind*x) ddl 

n; ” * he 1 r; 


$]e: 

Ibrfset (ind^x) xx ddj 

s:=^"brseL"; 


$lf: 

Ibrclt dd^x xx ddl 


B:='brclr': 

$60 ; 

s:='neg‘; 

$63 : 

B:=Vcotii*: 

$64 : 

s:=* tsr*; 

$6/: laisr ftnd.xjl 

s:-‘esr': 

$68: Iasi (ind*x)] 

GT^'asl': 


Sec 1 

B:-*ldd'; 

$ed 1 

8:='std■; 

$ee : 

s:^*idx'; 

$ef : 

s:“"stx*‘ 

end: 

jsEcSlr:=concal fsrcStr . s); 

FetchByte t y,errFlag * eofFlag); 
if not llexStr2Byte[8^operand) then 
badHexFiag:=TRUB 
else 


begin 

operands!;n^concat ('$* ' .x' J; 

if (opcode In cTwoByteSet) or 

(opcode in cThrcoRyteSoi) then 
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begin 

FerfrbByte (a ^ errFlag. eofFIag J t 
if nof HoxStr^Bytcfs*operjind) then 
badllt?xL''lag^='rRUIS 
else 

begin 

operandSt r ^“concat(opecandStr, 

ggc2Spaces. '$\s): 

If opcode in cThrneBytfiSeT then 

bcgl n 

F^tchiSyte(a,ernFlagneofFlag): 
if not HexStr2Byt€(s* operand) then 
badHexFlag:^TKUE 
else 

operandStr:='concat (operands tr, 

ggeSpaee/S' .a): 

end; 
end 

end: 

end; 

if not hadHexFlag then 
sreStr:*€onca t{sreStr,ggcSpace,operandStr) 
else 

orcSl r :"'ConCti i (sreSif ,ggc£pat:c*operartdSt r, 

ggcSpace 1 4*. ggcSpace, * Invalid hex by Le! *) * 

PoLStringtsrcfSir.etrFlag); 
end: 


The opcode bytes twice 

The “post byte'' instruclions offer a somewlKii different 
form of complexity in thaJ the first thing to be tkme is fetch 
the "rear opcode. The two-hytu opcodes are made 
neccessary by the fact tliat a tine-byte opcode can hold only 
2% possible values. When Motorola started designing 8-bit 
pnK.'essors with more than one index register, they needed 
more than 2% opcodes. Their solution with processors like 
the 6809 and 68HCn is a number of two byte opcodes, in 
the ca.se of the 6HHCT1 opcodes whose first bytes are $18, 
$IA or $CD use a second byte for the actual instruction. With 
the 68HClt most post byte instructions mse the Y-index 
register and many directly mirror X-regisier tnstnjcthms w ith 
llie sante upeudes. although some affect the D-accumuluton 

Iniiuil pixxessing of $JA instructions is showm in Listirig 10 


Listing 10 


JhtiCcwtA 

proci?durc Prtiee^sl A[var crrFlag.isofFlagtboolciin): 
viic 

ij,opi?raiitfSLr ,stcStr;atr255; 
tjpc Dde p operand: byte; 
badHexFlag;baolaan; 

begin 

h3dHexF!ag:=FALSK: 
sreSt r:“^cSpco: 

F e L ch By t e t s * vr rFIflg.eo f FT ng): 
if UexStr2Byte(f.opcode) then 

begiji 

SendBadHexKessCerrFlag); 
exit: 
end; 


caae opcode of 
$81; 

kpd (Tdddd) 

a:='cpd": 

$93: 

kpd cfiJl 

n:"*cpd*: 

$a3: 

[cpd dd,xl 

s;^'cpd': 

$ac: 

fepy dd.xl 

s:"'cpy'; 

Sb3: 

icpd ddddi 

fi:^*cpd *: 

Sen: 

fldy dd.xt 

s:-‘ldy‘; 

$ef 

Isiy dd.xt 

s:^'sty': 
else 



begin 

PrnrenRNnfInSetn(oprarie<errF]agJ; 
exit; 
efid; 

end: ^E:±i^ie| 

srcStr:^concat(src$tr,s): 

FetchByt e ts,errFiag.eofFiag); 
if not HeKStr2Byte(£.operand) then 
ba dHnxFl a g: =TRtIE 
ntse 

begin 

C£i£e opcode of 
583 : 

begin 

QperandStr :“concat (' jf$', s): 

FGt.chEyt#^(npftrrFlag,eofFlng); 

If not Hf?xStr2Ry?nffl*oper.ind) thi^n 
badnoxFlag:“TRnFt 
else 

operandStr; =coricat (operandstr,s): 

end: 

$b3.$93 : 
begin 

operand St r:"r,nnrat{‘ ,n); 

1r ypc od e”$b3 l h en 

begin 

FetchBytets.errFlag,eotFlag): 
if noi HexSir2Byte{s,operand) then 
badHexFlag:-TRU£ 
else 

nperandSt r: ^oncat (operandStr, s); 

end: 

end I 

othervise 

operandStr r^concat('5 \ s * \ x *): 

end; 
end: 

If nor badUcxFlag then 

isrcSu:^conedi. {srcSi r .g|cSpaee.operflridSif} 
else 

sreSt r :=concat (srclst r .ggciipuce, ii. 

ggcSpace,' - Invalid hex byteD: 
PutStrlng(stcStr.errFlag): 

end; 

The second o|xodc byte is fetched and converted to 
numeric fbmt, then used in :i case siatenient to .select the 
instnjninn mnemonic Openind liyies are fetched as needed to 
a)iu|KXse the output string. 
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The modes not shown 

The rest of the iiddressing modes are handled in a 
manner similar to these examples with the exception of the 
relative address mode whose code is shown in Listing 11. 

Relatively coding 

lixcept for the “bsr" (branch to subroutine) instruction, 
whose code is $8d, the opcodes occupy the range $20.,$2R 
Tlie ninenionics for iliose sixteen codes are contained In an 
array of three-eharacter strings indexed by the opcodes, 
Using a set [$20.42Ft for a qualifier^ an array element or the 
string 'Irsri is copied to siring variable s. The single operand 
byte is then fetched and the output line assembled 

Listing 11. 


Process Relativf 

procedure ProcessRelative(opcode:byte: 

var errFiag,eofFiag: boo-ieanj : 

type 

tOpStrRay = array [$20,,$2f] of gglStringJ: 
var 

S t operandStr , sreStr: atr25‘5: 
badHcKFlag:booleani 
index: in1.ege'^^ 
operand:byte: 

const 

cRelSet :ggt£yteSet-[$2Qt.$2fl; 

cRelCodes : tOpStrRay={ 'bra ’ UhrnV. *bhj ' /bis ’ , 

* bcc',‘bes‘.'b ne / 'beq'» 

‘bve \ ‘bvs' /bpl ■ . *bmi ' , 

’bge’.'bit’ /hgt'p’ble■); 

cBdCode :ggtStrin63=‘bsr/ 

begin 

badf{exFlagr=FALSE: 

srcSirs^ggcSpaco: 

11 opcode 111 cRelSet then 
s :=cRelCodes[cipcodeJ 
else If opcode=S6d then 
sr=c®dCode: 

srcStr:^concat(sreStr,s); 

FetchEyte(s,GrrFlag,eofFlag); 
if not HexSt r2Byte C f: . operand} then 
badFoxFl asi^RlTR 

else 

S!=t‘oiicat i 1 

if not badHexFiag then 

fircStr:=coricat (sreStr .ggcSpacetSj 
else 

arcStr;=cQnnat(HreStr,ggcSpace pS t 

ggcSpacei ' Invalid hex bytel/; 
PutStrfngtsrcSirtCrrFlag )i 

end; 


Jack and Jill went up the hilJ to Letch a pail of hyles 

You may have noticed reix^atcd calls to the FetchByte 
procedure in the previous code lipStings. FetchByte, shown in 
Listing 12, is MacL£irfy\K operating engineer h retrieves 
S-records from tlic input file and chops ihein up, delivering 
bytes of data as needed. Available data bytes are held in global 
string variable gS19Ltne, which is initiali/ed to an empty 
siring. If its lengdt is ^ero when we enter the while loop, a 


new 8-fecord is fetched from the input file. The header is 
stripped off and if it is "'89" weVe reached the end of the file; 
if the header is neither ""SV nor tlie badLiiicFlag is TRUE 
- in either c^ase we exit without further ado. If the header was 
“SI” we strip off the byte coiinr, address and checksum and 
assign the remaining text, presumed to lx? I>ytes of useful data, 
to the global variable gS19Line. linally, we chop off a byte of 
hex data to take home. 

If the length of the siring gS19Lme is greater than zero 
when we eater the while loop, we simply chop off a byte of 
data and leave the loop on the next cooditional check. 


Listing 12. 


Ft^tthByte 

prDcefl(jrG Fetc^hByteCvar fj:str255i 

var errFlae.0ofFla£:botitc3n): 

vat 

sZ.txt :str255: 

c rchar: 

I. nuniOfBytes :byte; 

S9Flag.bBdLineFlag:boolean; 

begJ n 

st^ggcNLillSi ring: 

eofFlag:"=FALSE[ 

erTFlag;=FALSE; 

while (not CeofFlag or errFlag)} and 

(a-ggcNullStriag) da 

begin 

s:=ggcNtinSiring: 
if length {gS19Line]<l ttien 

begin 

FetchLine(txt,eoi'Fiag.errFlagJ; 
if not errFlag then 

begin 

S9Flag:=FALS£: 

StripHeader(txt.badLineFlag,S9Flag); 
if S9Flag or badLineFiag then 

begin 

txt:="*; 
exit; 
cfid 

begin 

StripByteCountftxt.numOfBytes]: 
SttlpAddr(txt); 

StripCheckaumCtxt); 
gSi9LinGi=txt; 
end; 

end; 

end: 

[chop off byte to return withj 
E i^copy [gS19Liiie. 1.2}: 

Delete {gSl9Line/ .2); 

Tnr. (glyteTota 1) : 

end; [while] 

end; 


Running IVL^cLAitjftY 

when you run Maclarry the window appeal's and 
nothing much happens other than the relenlless advance of 
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the* clock al upper right, I'he offset and HPKOM arldress 
viikics, which boll) ticfauli to iccro, arc displayed below the 
time. Use the Address, Offset, and Speed menus to make 
any needed changes from defaults, then punch the Xto" 
[>imon. Select the S-record file to !k" dissected and click 
■*Open". (A sample S-record file, buf52,sl9, is provided in the 
archive.) 'Ihat's it. You’ll see the ASCII scroll by in the top 
window-, followed by succe.ssive disassemblies in the big 
window below'. 

To continue with dissections, adjust the offset, address 
and speed values, then punch "Go’" to repeal. 

Conclusion 

While Mac Larry might not he an expensive 
microprocessor develof>ineni tool, it is a useful utility for 
poking around inside M68nCli 8-record files. In conjunction 
with an assembler tt can be a useful learning aid for 
embedded ctmtroller assembly language. 

The files available for download include QxIeWamor Pm 
Pascal projects and .sourcei'cnle, as well as c«)mpi!ed 68k and 
PPG apps. Freeware 68HC11 Mac cn>sv-assembiers, S-rccortlfilcs 
for tile BASIC 11 inteq’)reter and BUFFALO monitor for 
dis.secting are available at the URLs noted in the references. 

Happy dissecting. 
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NETWORK 

MANAGEMENT 


By John C. Welch 


netOctopus 3-5 


Reviewing the premier Neltvork 
Management AppUcation for the Mac OS 


Disciaimi-r 

] have \xicn a ncLOclof^as customer for almost 2 years, aad 
liave iKvti more than a little pleased with the pnKlucl. and most 
definitely witli the pro);rammers and sU[>|XJri staff wiio have 
followed the pr<Kiut'l acros^s its last three *>wners to Its cairreni 
home at Netopia. I was also involved in the Inaa pro^ain, 
must heavily with the SNMP feat tires. As a thank you lV>r my help 
and work, Netopia ^^ave me a free copy of one of the program 
modules that would normally Ix" a purchased protluci. Having 
disclosed this, on w'iih the review, 

BACKGROirND 

netOctopus Is a network and trompuier management 
application that allows you iu monitor and ct>ntrol various 
hardware devices on your tietw'ork. netOctopus, also allows you 
lo manage the configurations t^f l>oih the ofxraiing system and 
applications for Windows NT and 9S/98 PCs. and Macintoshes 
on your network. By using the SNMP (Simple Network 
Management Protocol) management addition, netOctopus can 
also monitor, and help manage almost any tJeviee that supports 
the SNMP prtjUK’oh including Unix workstations, printers, 
routers, hu!>s, or even uninterrupted pow^^r supplies (UPS), 
netOctopus operates at'ross TC'P/IP, NetWaije, and AppleTalk 
networks, and can run aity one or all of thtise protocols, 
netOctopus runs as !x)!h a server and a client, and either |Xiri 
runs on lioth 32-bit Windows and Mac OS platforms. Finally, 
netOctopus supports auLomatiotv'seripting on Ix^th platforms, 
AppleSc ript on the Mac OS, and Visual Bilsic on Windows, For 
tills rev iew, I wiP concentrate on a Mac OS server with Ixjih Mac 
OS anci Windows c'lienCs, and llie SNMP add-on, 

INSTAIIATION 

Installation of the netOclo|)us adminlsirator is lairly 
straightforward, wiili the usual choices txiween F^isy and 


Caistom installs. You am cIkkisc eiilicr die default kx'ation at the 
root of your startup disk, or a sjxcified folder. If you vUoosc easy 
install, then the Administrator, File Seripier utility, elieiit ufxlates, 
and template files are installed to ifie default legation, unless you 
clon'i sjX'cify a dilTeivnt location, 'lliere are also a number of 
shared libraries placed into the Kxtensions folder, alt mg with the 
Mac OS NetWaa-! clienr If a ctisiom install is picked, then you can 
chtK>se the type of aciniiiiistrator you wish, either 'tTavorecF or 
sumdani. (riavc^red is a special install package that is used only 
with davorecl clients hx (ertatn siLuations. For 99'H> of you, the 
standard adminisiraUir is what you want.) In version 3.% die 
adniinisirator is PtJWerPC only, so if you plan to tgignide an 
existing installaiion fh^ir’s running on a 68K Mac. its time to 
upgrade ihe .server Mac. 71ie File Scripter utility Is still either 6HK, 
PowerPC -native, or Pat and you can chcxxse which version. Tliis 
Ls aistj the install to use if you don't want to have the NetWare 
client installed on yiiur Mae. 

Finally, you can also chcxxse whether to insiall the client 
updates. Other installed options include some default 
AppleScripts, ;ind a series of scri[its and installer documents that 
allow ytju to |)CTforni remote iastalLuions of the Mac: OS, versitms 
and greater. {Since 8.5 Ls the first version of the Mac OS that 
ckxsn't require multiple human intervention.s once you sum the 
insiall, this is the first version that can he supported prac tically ,) 
Once die options are chosen, the installer runs, and you can 
either install more options. t|uit, or restart the server. Since you 
have to restart for die netOctopus libraries tc> loiid, yoiflJ have Lo 
do this ixfore you can set up the server. 

One of the things I appreciated alx)ul die insiall [inxeduie Ls 
th:ii you are not foaexl to do a lesUtrt. Since this is the type of 
application tlial will pnilxifily lx ninning on an existing .server, 
casually forcing ycxi lo relxxii is not the kind of Ixhavior tkit Is 
conducive to happy networks, scivers, users, or adminIstrainrs. 

Administrator Seiup 

I lie kisic setup is decent enougli for mcxsi, hut there are .some 
quibble's. For one tiling. Netopia follows the common prac tice d 
setting the default memory alkxxition to the minimum nct-xled to run 


John Welch <jwelch@aer.com> Ls the Mac and PC Adniinisirator for Af^.K Inc., a weather and atmospheric science coinpany in Cambridge. Mass. He 
has over fifteen years of experieiu c' at making conipLiters work. His specialty Is llguring our ways \a make the Mac clo what ncikxly thinks it can. 
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Llie applinttion. 1 hiK\ to tltuiblc it to gel iliingN to it asiiblc level with 
inure tJmn jnsi a few ciienis. ('IIlls ts one ]>raLiice dial ttK> many 
other Mac adniinistnriui^, and I htrariily wish v\'oli 1<.I end. It may 
rriiike for worst' Pli. iiut al least I wouldn't liavc to aanenilx^r to set 
realistic default sellings for loo many applications to count). The 
preferences dialog is split into fairly logical sniisetiions tiiat deal with 
network protocol preferences, k>gging, notificniion, printing, 
general SNMP, (if tlie SNMP atld-on is installed). softwiue metering, 
an<.l printing. netOctopus^s pieferencit^ ate acrualiy fairly simple to 
st;i lip for most usens, Ilte TQ^ W, SNMP, and Genc^ral paTcrcnce 
settings make use t)f k:xi ('onfiguration fdes to 60 a lot of tlie setup. 
Although jxaeniially annoying, netOiopiis iTuikes lilx^ral use of 
exainpk^s in the stimple flies to make sure tliai even sometine with 
only a Irasic knowkxige of netwxirking can set u[> tfiese files 
conectly. Although not a standard way to configure a Mac 
applicTition, the confjg files m: a Ixxin to anyofM:* who ncxfds to 
configure multiple neUTctopus administration com])Uicrs, as they 
allow civtUing Lind changing configs via file aiptes. 

netOctnpiis also allows a nice degree of llexil^ility' in 
assigning administrator rights. As shown in figure 1, you can 
have multijilc admintsinirors with different levels of control 
rigliis. One or more adniiiiislralors can also be designated a 
"Supta- Administrator,’" analogous to rtM>t in the Unix world, 
which give's you all rights to any netOaopus , iTie Lidvaniage of 
this is that instead of an all or nothing approach to a.ssigning 
administrator rights, a manager can give one person the ability 
to only gather informaiion from clients, aiKHher to do ihai AND 
make changes, and so on. This is impentant because in a 
situation where iietOctojxis is running a network of hundreds of 
computers, you don't wxini only one [person able to administer 
them. On the other hand, you don't want to give every [)ers(jn 
using the netCXtopiis adminisiniior c'omplete control over the 
netw(irk. IVy allowing you to define levels of permis.sions, 
netOclopus maintains the !k*sI Ijalance iK'lween ne.xibility, 
usability, and securiiy. 



tigitt^ L 

x\not}ter evay in which netOctopas maintains its flexibility is the 
way it allows yixi to am tfie administrator ]>tt>griTn. neiOciopiis’s 
licensing is based on the ('lassie razor model. You pay almost 
nothing for the admin [>iogram, instead, yon pay for c'aptibilities, in 
terms of nnmlx'rs of clients adniinLsteitxl, and pnjgram extensioas, 


such as the SNMP add-on. Tlic advantage Ls tliat tt allow.s you to 
have multiple copies of the Lidministrator pmgram if needed. For 
exmny>lc, my main AppleShaielF server mas a cx:>py of nc-tOciopiis. 
However dial cojiy is asccl mainly for status chexhing of computers 
and software liceases. f-or installatioas, 1 use' a noil ler copy that aias 
on my lajHop. 1 Itave the sjime access to tlie clients, but I don"t luive 
to wxirry alxiut inicmipiing any timed jdis on the server. 
netOctopiis implements tliis is via an admin key file, that is Cleared 
wlien you log in to netOaopits for the firsi time (atk^ entering your 
.serial numix.T). Ihe admin key file, along with other neiCXt<pLis 
pn'ferences is kept in the [laTeiences folder of the slaiiup drive. By 
copying just die admin key, or all the pa'feamces to other Mat's 
ainning the netOctopus administrator, you can make setting up a 
neK Xtopus admin server as L*y,sy as a file tt>py. Til is is very^ nice 
when you have to set up 4 or 5 Macs. Sincx* tlie client can run on 
the s;ime Mac as llie admin progntm, you can use die main 
neKXtopus admin pa)^;im to insiull and set up other netOctopus 
admin servers, 'flus niLikes nelt.Xlopus function very' nicely in an 
enviixjument widi miiltipk' locutions and multiple admin servers. In 
addition, il you set uj:> your iosialkition source drive properly, one 
shared drive ran Iv a neKXtopus install point for niuitiple ,servers. 

lVl4t; OS Sifppoirr 

netOctopu-s ckx^s a mote* titan ade(|ULUe job ot supporting beth 
new and traditional Mat‘ OS ic'chnologies. Drag and dro|) is used 
t^veryw'here txKsible, rn>m pri'lerences dbdogs to in.slallation dialogs. 
Sc'tting up views in dilleivni windows is also done via drag and 
di'op. Another technokjgy that lecrives excellent ,siipp(.irT Ls 
AppleScript. The didionaiy' is ntJt only well sKxked with ^ any 
function that can Ik* actxsscxi from the menus or dialogs, but the 
comments in the dictionaiy aie dc^ir, concise, and e;isy ro follow . 
Mmoi.st cveiy^ dialog Is non-mtxlal, w'hich means tliat if you nexd 10 
go to anothcT app, or niount a drive in the middle of a netOctopus 
st^ssion, -you rm Ie:ive the dialog lx>x vvheit* il is, and do things - 
aixxind iL neiOciopiis has also siipisojted Navigation Services ,sin(e 
version 3 0. wiiich is another feaiurt* tfiat helps you get your work 
done “ witlioul llie pix>graiii and interface getting in your way. 
Finally, netO( topiis also supports the KeyChuia. aintnxJuccxI in Mat' 
OS 9, Cousidering tluU the average user of this paxluci is a network 
admin, who imy Ixive a doxc-n or so diflerent login IDs and 
[mswords, any elfoit made to mduce or autoinaie this pnxress is 
greatly afipretiaied. 

NFIWOKK jYDMJNIS'J RA'IION 

Since netOi to[>us is a network administration program, liow^ 
does it perfomi those tasks? in a \vord, excellent. Now realize, 
this IS not the program to single handcdly nin a netw'ork of 
13,000 Mac-s, Windows, and Unix w^orksiations Irom a single 
location. However, thanks to the distributed nature of 
netOctopus's architecture, and the decenlralixed managemeni 
sy,stem that can be used wath netOctopus, you can run that same 
network with ntuliiple servers, and some judicious AppleScript, 

Workstation Administration 

nci(3ctopus's first .sirength Ls to help you nuinage tlie compuiers 
on your network. User infonuaiion, prex'ess control, lastallaiion, 
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ainOgitnilton, and vimuilly any task that an atiniiriLstnitor wijnld 
need to [x^rfonii c*in tx" done on Ixjtli Wintiuws and Macintosh 
computers. One new featuiv in version 35 Ls enhanafd pnxess 
t:onln)l If you want to see ju,st what resauices Word W is usin^ on 
a G4, o[ien up that iajinputer'.s wr>rk.station infonnatitrii window, 
.select prcKesses from the droj^ down list in the windtiw, and flitn^ 
it is. Even Ix^ter, is someone playing loinh Raider on coj ujxmy tiiiK"^ 
Select that pitxess and kill it just in time to (lair tile scie^ims, llicn 
send that user a polite reminder of wliai a)nsiimtes appn:^pfkiie 
sofiwaie on c'ompany computers as you delete t!ie game rK>m that 
Mac, You can also asc nciOciopus's AppieStTipi suppfiri to crate a 
scrip! that wr^rks in conjuncticHi witlr Lite iDo script .sc'heduler to 
chiX'k for varioiis g;tines by creator ccxle, and do all lliLs 
aiitonuilicitIIy. nclOctopus’s ciipahilities extend well into tiie cioss 
platfomi ralm as w'cll. One ut the most tedioim ia.sks for a network 
admin in a multiple platfcmn neUvork Ls enabling jilain text 
[rasswoals in Window's NT so that these Ixjxes can sec the 
ApiikcShaadP serven> on the network. Tlrinks to the ISTf team's 
forc'sighr. the only way to do this is via registry cxliis. Now, hopping 
fmiii machine to macitine is tedious at Ix^st. hut with netOctopus, 
you can cb them all at once, Sc'leci the mitchines you want to edit, 
go to the Comrrutnds menu, chcxxsc Wtndows Kt'gisiry, then New' 
Regisiiy Vdlue..., and enter in the coraxi values, CjO Imk to the 
Q>miiiancLs menu, hit Resiari..,, and voila! tliai NT Ixxx or Ixjxes 
can now see your network, Eveat Ixitei; cieaie a link" AppleScript, 
like ilk! one in listing 1 Ixlow, and c'ompres.s ilie wliole thing into 
two steps, Jliai s right, nciOclopus allows you to do sci ipi editing in 
the Windows RegisUy^ and a wliole loi moix'! 


listing 1: Enable NT plaintext passwords: 

tnstjll rlit ?rr registry' haek tlijtt allcjws Windows .Vt 4 witti Senice Pack 5 or 

hjglier til ust; plain rm pas,wi>rds tin a nciwnrii 

prop^^rty NqSelectionErr : ”Thete Ik no compuLcr selBcted, 
Please select onel” 

teil application “nntOc f npiiti" 

set theWinriow to window ^'CaittpuLers" 

fipr thcScU'CLlon to selection of tbeWlndow 
tf iheSalGction exists then 
add registry value of theSelecTjon region ry key path 
"JlKKy_LOCAL_HACHlNE 

\\SYhrtiM\\i;urrailCojitn>IScn\V»cr\'ico\\Hdr\\PanimcU'r?i'' rogiatry value 
name "EnablePlainTextPaBRword” regisLry value type number 
value registry value ^1“ 
else 

display dialog NolSeiectlonErr buttons l**Okay”i with 
icon Slop 
cud if 
etid tell 


If nothing else, the alxwe listing is a gtK>d reminder tT why 
a very^ solid passsword pttlicy is required ibr tliis product, 
netOclDpLis can be used to do a lot of damage in Lilmosi no rime 
to a large numlx-r of compiitetx 'llie entire list of conii>uter 
administraticjn and reporting features is text long to show you in 
ihis review, but suffice it to say, short of nmiote control, and 
making cotTee, (which neiOctopus will allow- you to get by with 
niLicli le,ss ), if ytju can tlo if to a Mac or Win'Iel IKl. netOctopus 
can do it easier. You may never gel up again! 


Software metering 

Possibly one of ifie most onerou.s and tedious duties an admin 
has, is dealing with licease comf)liant:e. Tliis is a thankless, and in 
these- networked days, e.ssential duty, 'niankllilly, oetOciopus 
makes ihings c'asier for you liere as well. By using a lemplate 
ckxument with the file iy|xs, cTeator codes, licenses owned and 
ap[ilic:ition name for e:ich appliotion, you can have netCXlopus 
check your neiw^ork tor applications in icse, and see if they aie 
legal or not. (Luckily, Netopia providc,s a sample dcxniment with 
ovL^T 400 emtries for everything from FileMaker Pro to A-K) Aiiack, 
TIk'ic are also clear insmictions for modifying this dcxunient for 
your own needs.) iiet(Xto|)us also incudes prefcronce ,setiings l<)r 
automatically running the meter, exportitig the lesulLs, saving llic 
resulLs in a net Octopus datalxise file, and mnning AppleScripts 
after finishing a nxiering session, (See Figure 2), 




j iDrop a filder far the riBuJla here^ 
I^ra^an \ft rua here 
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Figure 2 


Software Iiistallatioii 

The ability to remotely install software to multiple clients 
simullancxkisiy is another major feaUire of mo.st network 
administration packages . Here. netOaopus gets a mtxetl review, 
v\ [licit Ls only panially its fault. On the Mac side, netOaopus 
tioes an excellent [oh installing software. If the .software you 
need to install u.ses Apple's installers, sutii ;ls a ColorSync 
update, netOctopus can directly read the installer [>ackage scripL 
and allow you to sta the same options as if you were doing a 
tnanual install Once you install any ,s<jftwaa‘ \o computers 
at f>nce, with less effijit titan insialling ii on one itianually, and 
you wall never want to go hack. 

If the applicition usc*s another installer such as ISiuffit 
InstallerMaker or Installer Vise, then yixi cm still iTcate your own 
installs, hut it gets a little moiv complex. In lliese eases, you need to 
use* the I'ile .S<Tiptef utility that comes wath netOctopus. Itils 
application allows you to install the appliaitif)n on tht* nerOtopus 
server, ami then you either manually tell File Sctii^Ilt wheie liie files 
to l)e installed need to go, anti when* they are on tlte sc*rver, or you 
use a snapshot to build Uiis inlbnnation. Using Kile Scripters 
snapshot facility in valve's uiking an invarlor> t>f all files on the server 
prior to softw^aie installation - , or snapsliot. iiistalling lire sofiwaicr 
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Lintl lakin^ anoihtrr si-uijtsJuh after the iasiall is coiufildc. You tlien 
tell rite St'riiiier which snapshot lo Li,st‘ as a Ix'fote and w'hich to iLse 
as an after File Scritner ttscs the diftea-nce lx'twet‘n \\w W) lo 
nealc ilie installer for the softwaa*. You ran eiiher usc‘ this on an 
appliauitm hy application basis, or iaslall several apps at once. Ihis 
methcKl Is llu* Ix’st to usc^ lor aj>pIkaiioas with a lot of hies, soch as 
e 98. oj’ Exodus 7.0, Once you have Niilr the File ,St:ri()tLT install, 
rej>ardless of methtxf the final stt‘p Ls to build an Apple installer 
fn>in Ele .Se npters. This Ls as simple as telling Mle Sc'ripier to 
an Apple liisiaLler, whethei^ to copy or move the files to tx installed 
into an install folder, and vvliea.^ lo stive everytiiing. On ti CkV^fH) 
.server, cieating an Ofllcc 98 Afsple insialier of evcrythirig l)ut ilu‘ 
exim clip art UK>k less than a minute. 

If till you need to do is a^py soiix tiles to install them, then you 
am iLse the gentTit' Inslalh.. (jjXiuri in the oamniantLs menu, (live 
rH-lOttopus die kxul kxaik>n of the tilej or folders, and ilien pick 
the destination. neiOciopns lets you tdKX>se aliiiasi every sjxxial 
folder in a Mtic from ti drofxiown list, so it Ls rare that you have to 
manually iy[X (jut a [xiLli 11iis o|aion also idlows you so opt:n [he 
file after its copied, w'liieli is vtay useful in conjunction with 
AppleScript. Ihis Ls how I do my desktop printer setups. I luse 
neiCXtopus to a>py over die files for the printer^ dien copy 
o\cT a scn[)t tliat uses tlie desktop printer strripling in die Mac OS to 
automaikally cieate the S printers diat we liave at AtvH. To do this 
on 30 Mat:s lakes alxxit S miiuttes, inckiding copy rime. 

On the ’Windows side, tilings aa^ a little harder Since 
netOctopus on the Mac can only start >X'indows execuuibles, and 
pass them a st:lie’s f>f ctJiiiinanLi line instaictions, the miniKe install 
capabilities are hit and inLss. i'or something like OfFk.e97. its a hit* 
;ls shown in Listing 1 lx-km\ Htx^ause liie Oflice 97 iirstallei supports 
a full ninge ofcomirand line jxiraiixters, i arn fully automate this. 
For ppograins sucli iis Netsctipe on Wincbws, you can rL'irxxely sum 
die ia^^all, but must choose* options inanually at die machine, or via 
d’imlutkiu, which integnites nicely w ith netOetopiis, ('lanbuktu anti 
nciOciopus I lave always worked well ttjgethcr, even Ixfoie iJie 
same company owned them,) 

lasting 2:i NT Office 97 Install Script 

'rhis si. rip\ tells neKktopus to iii^UdJ UfrKt W7 from :i network insiai piiiil a 
Remote mjit'hini^.'rtlt? cmly rminiuil tnicnciuioo needex! ts M the licKk lopus cml, 
to L-nttT iJn* tisiY n:tfiir for (5riit:c. 

property NoSelectlonErr : “There ip no computer selected. 
Please select cjTie!“ 

property theServer : “WWKeLrosjpeciWSharfjd files” 
property thePassword : *' 
property thePath : ”\\pc_flies\\affice9/*' 
properly rheRKeeutable : “eetup.exe*' 

tell applleailoti “Finder” 

set theDialogkeply to dlcplay dialog Enter the user's 
name for Office 97"’ default uimwcr ''Computer Services" 
buttons ["Okay", "Cancel"! defiiull buiton “Okay" with leon 
caution 

set thea,serKame to text returned of LhenialogReply 
end Loll 

tell applies tl DTI "uciOtinpus” 

set theWindow to window “OomputerK" 

set theS^lection to selection of 11101171 ndow 

if theSelection exists then 

execute PC installer t>l theSelection server name 
theServer security domain level user name “root* user 
password thePassword executable path thePath execuLablo 
tbeExecuiuble execute using any drive letter parameter 


“/b 2 /k 173^123^^67V” /n V"" & cheUserName 6i /o 

\"AEK lTic,“ /qi" 
else 

display dialog NuSeleftionErr buttons ["Okay"I with 
icon stop 
and if 
end ipll 

In my vicw\ mtOcltJpLLs wouki greatly benefit from 
increased integration with InstallShiekL The installer used for 
99^yo of all Windows programs. 

Other Admiiustration 

in adtiitkm to the Mac and Win'I'el supfXirE, neiOckjpus can 
also viitiially mon(tf)r any device on your network via the 8NMP 
add-rm. SNMP, wliit li is the neWork management proux'ol for 
most networks, is usetl to monitor everything from printers, to 
routers, to databases. SNMP uses agents, which run on the 
devices and res|x>nd to queries, and MIBs, or Management 
Infomiation Database files, which contain the inlbrmatioti the 
agent uses to determine ils capabilities. At its maximum 
capabilities, an SNMP moniujr can receive and send messages, 
or traps, to SNMP agents and devices on ilie network. These 
traps can lx* used to gel information, or tell a device u> shut 
down, restart, etc. def>ending un the MIB file. ne!(_>ctopus comes 
with support for the standard KFC Mili files, and also lias 
support for a numlxr of orhcT MIB hies, sudi as printers, and 
other Apple S|X?cific MIB infoniuuion. Although nerOcioptis 
(kxsn'i directly use conventional MIB files, (an omission I liope 
is fixed in the next veision), Netopia lias set up an email address 
for you K) semi MIB files to, w'hca* they are compiled, into 
nelOdopus rntxlules, and mailed hack to ytxi. (Releasing llie 
ct>iupiler w ould lx* a handy step as well. ) 

Once the MIB mtxlulL's am iasmllcd, nuiOaopus am send out 
retitie.sts for intbmiation, and tlLsplay the lesulLs. 11ie handy printer 
MIBs, allow you to qiiuTy the printer and .sec* if it has an error 
condition, sudi as a paiier jam, etc, VtlUi tlie advent of T(]iMl^ 
printing, the ability of the printer lo notify^ you of an enor has been 
lost sonicw liat, so iliLs Ls a niev way for an admin lo make up for 
tltis loss, liifortunately, m*t<)tiopus Ii;ls Id initiate the SNMl^ 
requests, so if a router Ls Imving piobleins, it ain’t send a tnip to the 
nettltio[)us adnunisiratoi; it has to w^ait iioiil ii is queried hy 
netOelopus, '111 is is a I rig pari of SNMP-lra,sed management, and Ls a 
laige, although not criiica! lack of ability on netOctopu.s^s part. The 
folks at Netopia have told me that they an* working liard on adding 
Iraf) SLipiXJit to netOaopiLs, whi< ]i would then pul it on a ixir wath 
oilx*r m;inagement piickages, 

Q)N(XlfS 10 N 

nei(.)ctapu.s i.sn’i perfect, and could use more complete 
SNMl’ support, direct MIB suimport, and better insraller supiiori 
for Windows ajaplications netOctopiis doe,s pcTfonn other tasks 
extrenidy wdl, so the overall im(>ression Ls extremely positive. I 
endorse this package wiili tlie highest recommendations . In the 
end, 1 give it these thanks: With netOctopus ihe number of days 
J donT work late has draniaiically increasexL and for a Network 
Admin, that's the higliesi praise* of all. K 
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UML Distilled 


A Brief Guide to the 
Standard Object Modeling 
Language 


ABOirr riii; IIML 

Before 1 talk hHm Mariin fowlerii 
iind Kendall Smifs UMf. IMHUed: A Brief 
Gidde to iIk^ Standard Object Modetinjf 
Uint\uagv iFowSer with Scott 2(KXJ]. ict me* 
tel I you a liny hit aNuii the Unified 
Modeling Uuigtiage (IIMIJ anti its history. 

Basically, software developmeni 
consists t)f three itcnited steps: analysis, 
design, and iiiiplementaiion. While you 
might invent your own prttgramming 
language for the implementation, must t)f 
us use a maiasiream language like C++ or 
Java. Amt mg otlier rea.suns, this allow's 
many devek>pets to read and understand 
tmr source code — at least loyally. To get 
the big picture Lite arcfvitecture) of a 
non-trivial software sy.slem. they pnahahly 
need to see the tliagnims and other figures 
vve sketched during the analysis and 
tk’sign phases. What the grapliical and 
textual eleinenLs in these figures mean 
(ahstract class, is-a relationship, nieihoci 
invtx'ation, etc.) is defined hy a jiKxleling 
language — again, thi.s might !>e an 
invention of your own. 

In the mid-nineties, several popular 
itiodeling langiiage.s existed. Grady BoiKb 
and James Rumhaugh dec idetl to end — 
i.e,, win™ this ^method war" hy merging 


iheir methods. (A method consists of a mexJeling language and a 
priKcss. A prtK'e.ss .suggests how to prtK’eecI with development.) 
And so, in 1995i they published tlie Vnified Methods !var 
Jacobson then joined Btxjch and Rumhaugh at Rational Software 
u> include his method as well. Because Bexxh, Jact>hson, and 
Rumhaugh (also know' as The Ihree Amigos) worked for the 
s:ime company, the Object Management Group (OMG) formed a 
task forte to standardize a non“pro[irielary method. One of the 
propexsaLs .submitted to the task force was Rational’s UML (Its 
process is the Rational Unified Pnycess IRUPI and is more or less 
indepentlent of the modeling language.) The OMG adopted this 
proposal with mcKlihairlons, and at the time of this w'riting, 
version 1.3 is the OMG UMl. standard [OMG B)991. 

For more on the liistory of the IkMl, as w'ell as on its future, 
see [Kohiyn IW9I. Btxjks alxHit the UML and the RUP by JLe 
'rhree Amigos are [BtxK^h et ai 19991. [factihson el aL 19991, and 
(Rimihaugh e/riA 19991 


UML DistilliiD 

This review^ is l>a.sed on ihe llrst printing of the .second 
edition of UML DLstilled, 1 have to mention tliis Irecause Martin 
li>\vler noi only updates the lx>ok between editions hut also 
Ix'tween primings. (If you're w^ondering why I don’t mention 
Kendall Scott: I'm not realty sure. In tlie Ixxrk it Sitys Fowler mth 
Scott and not Fenvier and Sctxt, Scott's name is jrrinlcd smaller 
than Fowlers, and the lexl is written in the first person.) 

UML Distilled encomimsses eleven chapters, two 
appendkxcs, a hihliography, and an index. TIuit .said, let's discuss 
the lx)ok diupiLT hy chapter. 

Chapter 1, hitnHiuctUm, is —oh wonder of wonders— the 
introductory chapter, l-ow'ler Tirst defines the terms niethoLl 
Utngimge mA pnxrf^^ and recaps the UMLs hi,stoiy. (Sounds a lot 
like my introduction .so far, dex^sn’t it? Well, guess w^here I stole 
it from!) He then defines the terms noiutiim and meta-model and 
talk,s alK>ul when and how to use the UML and other ol)ft'ci- 
oriented techniques. The derinition.s are important of^ course, l>ut 


Paul is an KF .student at llie Swiss Federal Institute of Teehnology Zurich (fmiZJ who has no idea w'hal he should tell you 
alxxit him this month. He welcomes suggestions at psevinc@ee,eihz.eh. 
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UN vuliuihlc is tiuu FowIlt sliarcs his vast t'xpjerienct’ witli tJic 
render Ixiili in this chui^tci anci all tiie others. 

Chapter 2, An OnU/m^/)ef'e/opni(^n/ Frm:ess\ is not 
the RL’P. Ffowever, vvhai Fowler diseysses in this cliapter is 
—aeeordirig to him— consistent with the Rl P. On about 20 
pages he I ream tour developnteni phastrs ealled inception, 
eia burnt ion, eonst ruct ion, and transition which togellier 
enctmipass his /oif-cem^mony process", llow' 

useful tliis chapter is depends on yt>ur experience anti what 
your next projects are. If you Ye new to {objeeL-orienlcd) 
prograinrning, 1 think you shouldn’t read this chapter yet; try 
first to deveitjp an approach tliai works for ytni while your 
code is not supjXised to be reu.sed. If you already liave 
gainerl .some prograiniuing experience with or without a 
for null jJiocess, the level of detail in this chapter is jusi 
perfect. More experienced prr>granimLTs prt>bal)ly want to 
C|iiickly read iliis chapter and then iiuwe on to the RCP. 

Chajner 5 t Case's, is the first chapter that actually 
discusses UMi elements. Fowler gives ex^miples of lx>ih a 
textual u.se case and a usc'-case diagram. I would have liked him 
to belter cxt)lain the so-ciilled extend rebtianshtp. Hut the other 
explanations are clear despite Ix^tng short, Tfx>. After reading liiis 
9-page chapter, f was Mv. to use use casc‘s riglu asvuy, 

Chaf)ier i, Class Diagrams: The Tssenliais, and chapter 6, 
Class Diagrams. Adtanceei Concepts, are complemeniary. 
While I understand Fowler’s decision lo treat class diugrarus 
in two <'luipters in order not to overwhelm the reader, tliere 
are a few tilings (e g., ubstiact classes) 1 w'ould have pur in 
chapter 4 instead of chapter 6. Bur ihat\s the only tiling I can 
reproacli these tliaplers wilh. Together, chapters 4 & 6 
comprise about a founh of the book. (Fm not sure I want to 
know what they would look like unfiliered...) Covered is 
everything I would liave thouglii of and more: subclasses, 
visibility, leinplaies. interfaces, etc. 

Chapter 5. Interaction Diagrams, is alxHir secjuence and 
collaboration diagrams. The.se diagrams visualize basic 
interactions between objects: method invocations 
(synchronously or asynchronously) and obfccl creation 
deletion. lYtvvk^r devotes about as much space to the five 
figures as to llie text lliat describes them. Most of the figures 
ihroughoui the book contain two types of elements by the 
way; actual UML elements and descriptive elements fi.e., 
arrows w'ilh a la])cl) which Ftwler added and w'hich are 
easily recognized as such. 

Chapter 7, Packages ami (Mllahorations, is some what 
confusing. It explains really well wluU packages are, but in 
the section on collaburations, Fowier should have better 
explained the relation betw^een collaborations, collab<jration 
diagrams, and interaction diagrams. For once, the distillation 
left [jack UK) liule. 

(Chapter H, Slate IHagrams, might aiuse some reatlers lo 
experience a deja vu as CML’s state diagrams are [rased on 
Datml Harets slatecharts. But even if you haven't heard about 
statecharts Ixflbre, you w^on't have any problem un<lersian<ling 
Fowier's explanations. 


Chapter 9, Actiinly Diagrams, descrilxrs activity diagraiixs in 
more detail ihan they warrent in this short lxK>k. — At least that’s 
what Fowler thinks. I hnd that the level of detail and the length 
of the chapter are just fine, '1'here's no real reason to remove 
anything from ihis ehapter even if other authors sunl writing 
alH>ut activity diagrams. 

Cliiipter 10, Physical Diagrams, is a very- short and very easy 
to understand ehapter. It introduces deployinenl diagrams which 
show- ilie phy-stcal relationship among hardware and software 
comjX>nents. And it introduces comj'M)nent diagrams that show 
ctimponents and their reiaLionslu])s, Actually, it introduces IxHh 
type's of diagram at pretty much tlie same time. And ilie only 
figure in this chapter comliines ihem as well. 

Chapter 11, UMi and Programming, IcxiLures an exam]:)le 
software project, Fowler uses clu.ss, object, and sequence 
diagrams as well as Java cixle ,snippets to illustrate it. The good 
news it: the example is nt>i irivial, Tlie l>ad news is: 
prognimming lx?ginners may fiave a hard lime undei'st;mding it. 
NiKc that additional information alxiut this example can lx* 
found on Fowler's home page IMRI.I. 

Ct>NC:LlJSlON 

'fhere is seklomly so much c'onstmsu.s alKuil sometliing IT- 
related as there is for ilie IIML. Ikali [lie industry and academia 
are ra[)idly adoj>ting it and —in my opinion— so should you. 

A nice feature of L^ML Distilled are ihe sidebars. 'I’hc'y brielly 
intrfKitice software engimrering 1 (K)Is and Lechfik[ues such as 
paiierns, CKC cards, and design by contract. 1 also appreciated 
I'owler’s [K)imers to other sources of information. 

While there are certainly .several goixl Ixxjks about the 
\ IML, you cannot gt> wrong w iih I'Ml Dfstilled, li is very^ concise 
without being superficial or dilficuli to understand. Anti even 
though it is only intended to lx* an imriHluciory' texilKX)k, I also 
itst^ it a.s a reference Ixxjk. 
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By Jeff elites <online@mactech. com > 


Developing with WebObjects 



Last month we U)ok a first l(K>k at WcK)bjms, and eoverec) 
all of the S4>i»x'es on the net you can turn to when evaluating 
WehO[>(e(ts—to help you decide if it is the right ttK)l for your 
projeci and to hel(> you eonvint:e others once you have decided. 
'I'his niontii we'll take a more technical look, and (‘over sites 
which can a.ssjst you in learning the Wei>Ohjects framework and 
develoj)ing WeljQlijeils applicaiion,s. 

The first place to turn, of course, is Apple■,s own 
documentation and training manuals, wliich are 
excellent. Kememher, WcdiOhjects and its underlying 
technologies existed at NeXT long hefore its 
act[uisttion hy Apple, so they are tiuiie mature, (for the 
record, WehC)l>jC’'Cts has hcen around since 19%, 4 ind 
was arguably tlie first application .server on the 
inarket.) Hut be forewarned that there is a daunting 
amount of information to absorb, and the learning 
curve is steep. Most of the material on the WebObjects 
Developer Documental ion site is also installed ItK'ally 
when you install WebObjects, but newer versions may 
l>e available on the web. (There is also a page winch 
track.s current patches, so you can make sure that your 
installation is yp-to-dale.) Also be sure to check out tljc 
Wel)Oi>jects Surxrival Oiii<les, wTitten hy 'f heresa Ray of 
Tensor Irilormalion Systems, w'hich give you concrele 
advice on many areas of learning and deidoying 
WebObjects. Lastly, although not directly aimed at 
WebObjects, tiierc is atidilional training material in the 
Mac (_XS X Server .sectiem of their devcltjper \\p site. 
This material doesn'i .seem to he highlighted elsewhere 
on Apple s site, and it can help yon in getting U]> to 
speed with the Cocoa (a.k.a. Yellow Box) franiew'orks, 
upon which Weh(.)hjec[s is iiuilt. 

WebObjects 4 Developer Documentation 
<http://developer.apple.conVtechpubs/webobjetts/webob}ects.hlml> 
WebObjects Current Patch List 
<hUp://til,info,applacom/lechinfo.nsf/aitnurn/n70037/ 
OpenDocument&webobjects> 

WebObjects: WebObjects Survival Guides 


<http://til.info.apple.eom/techinfo.nsf/artnum/n70109/ 

OpenDocumentStwebobjects> 

<^://ftp.app!e.com/Apple_Support_Area/Apple_Soflware_Updales/ 

MultiCountry/EnTerprise/webob]ects/guides/> 

<ftp://dev.apple.com/dewvorld/lnleractive_Media_Resource 5 /> 

Mac OS X Server FTP Site 
<ftp://dev.apple,com/devworld/macosxserver/> 

li is Linforiunau^ that there is not yet any 
comprehensive third-fiariy docunKmiaiion (probably 
because there is nut yet a market for it), because 
currenily ycni don’i have the benefit of multiple 
ap[>roaclics U3 ex(>laining the same material—on many 
topics, Apple's documentatit^n is the first and final 
worth Accordingly, it's a good tiring that Ajiple ulTers 
training courses in VX^ciiC)f>jecls (and Cocoa in general), 
because they are almost essential. Check oui ibeir 
training web site for dales, places, and prices for tltese 
c[as,ses, .some of which Lire provided through third 
parties, sucli as Blacksmilli and Tensor Information 
System, who also offer training courses of tlieir own, 

Apple “ WebObjects - Training 
<hTtp://www.apple,com/webobjecls/schedule.hl;ml> 

Blacksmith 

<hltp://www.black5mfthxom/training/30_course.html> 

Tensor Information Systems, Inc. 
<hnp://www.tensor.com/TrajningfTraining.html> 

Don’t let me give you the impre.ssion dial there is 
no third party WebObjects information available. To tlie 
contrary, iliere are some excellent resources on the 
wel'f—they just lend to cover specific Uif^ics railuT than 
being general inlrotluctions or tutfnials. A great source 
for tliese is ,Stepwtse, w'iutTi ho.sts original anicles as 
well as tracking current Mac OS X related news. Recent 
topics have included memory nianagemeni, 
authentication, and data validation. Also, Scott Anguish 
has created a pair of components, SWlable anil 
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SWMuillu, wliicli .simplify ihc process of dynamically 
generating tables and mailto links. 

Memory Management with Cocoa/WebObjects 
<http://www.stepwise.com/Arttdes/Technical/ 

Memory l\/fanagement.html> 

Using Checkboxes in a WORepetition 

<http://www.stepwise.com/Aftldes/Technical/ 

WOF_Checkboxes.htmi> 

Fetch limits in WebObjects applications 
<http://www.stepwfse.com/Aflicles/Techriical/FetchLimjt.hlml> 

Data validation with WebObjects and EOF 
<http://www.stepwisexom/Articles/Technical/WOValidation.htmi> 
Basic Authentication with WebObjects 
<http://www.stepwise.com/Articles/Technical/ 
BasicAuthentication.html> 

SWTable-WOTablePlus.,. 

<http://www.stepwisexom/Software/SWWebExtensions/ 

UsmgSWTable.html> 

SWMailto - yet another component 

<http://www.stepwise.com/Software/SWWebExtensions/ 

UsjngSWI\/lailtoTiTml> 

When the documentatiun slops helping and you 
nt'cd lo ask some (|Hcsiions, you have two places ro 
turn. Aj>ple IkxsLs a WebObjects Discussion Foruni, and 
Omni Deveiopment hosts u WebObjects mailing list (as 
weii as several other Mac OS X related mailing lists), 
which is archived on their site as well. 

Apple's WebObjects Discussion Forum 

<http://dlscuss.info.apple.com/boards/webobj.nsf/ 

by+Topic?Openview> 

The Omni Group Mailing Lists: WebObjects 

<http.//www,omnigroupxom/community/deve!oper/ 

mailinglists/webobjects/> 

Of course, before you start asking c| nest ions il’s 
good policy to check the FAQ. Unfortunately, there 
isiiT realiy an ofliciai FAQ perse, hut there are a couple 
of sites which arc a close approximatif)n. Missing Link 
(a.kxL Darwinhinux) hosts a collectitJn of Ups h>r 
Wel')Ohjeets, Mac OS X Server, and Darwin^ and there 
arc some real gems in here. There is also the 
WOSourcc FAQ; ids over a year oiil-of-dale at this 
point httt it'.s still C|iiite usefiiL 

Tips S Tricks for MOSXS, WebObjects, and Darwin! 

<http://www.darwinlinux.com/cgi- 

binA/VebObjects/MissingLink.woa/> 

WOSource FAQ 

<http://www.wosourcexom/faq.html> 


When you are done w ith tiic learning phase and actually 
start ixiikling a sire, there are a numlaer of tliirchpaity 
commercial prcjducts which can help you add advancc^cl 
FetUures. Kept>rLMill allows you to iTC^ilc ITTFs dynamically, 
and the Ulienl Signal Viewer from Wl-lXiS allows you to 
gra p h ic a 11 y m( >n i t c >r da ta t roi n Wi' I ^Ol 'j jec 1 s a pp M c atic >ns i n rei I 
time. WAPoljjcxs hei[>s you genenae WAP conienl for viewing 
with mobile devices such as cell pliones and PDAs. AncI 
especially intei'esting is Objectivc^Fveiytliing from T ipi op 
Soft warn, which lets you write Ccx:oa applk:aiion.s iLsing Pud, 
Python, and Tcl, in addition to the u.sual Objective C, Java, 
and WebScTipt. (You om even u.se multiple languages wathin 
the same cTiss, implcmenUng ,st>me melluxis in one language 
and other in another. Quite slick!) 

ReportMill Software, Inc 
<http://wwwjeporlmill.com/> 

Client Signal Viewer 

<http://www,wixom/ClientSignal/index,html> 

WebObjects gets WAPed 

<hTTp://www.maccentraf,com/news/9911/17.webobjects*shtmI> 
TipTop Flome Page 
<http://www.ti ptopxom/> 

After yoti’ve finished developing your ow'n sire, 
eonie to ours and visit the MacTccTi Online web pages 
at <http://www.mactechxom/online/>. eSlI 
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By Jessica Sluhhlefield <press_releases@maclechxom> 


JMedlv Design In*Progress Ships Interaction 3-0 

New relcrise improves Internet ion's support for server-side 
XML, iidvanees llie ineiiiliei’sliip subscrifnion eiifialjililies and 
introduces addilional features for making dynamic and 
personalized wehsites without requiring aripting. 

Media Design in*Progress shipped Interaction 3.0, the XML 
based Mac web server companion for building and hosting 
personalized, sexial websites. Key new^ features includes 
integraled Emile XML editor, expiralitm of membership 
subscriptions, conditional content that adapts to tlic nienilxTship 
status, prereciuisite restrictions to personalize pages depending 
on browsing history, upgraded visitor monitor, OSA scripnihility 
and rccordal?ility, among others. 
http://interaaiDnJn-progress.com 

AppMaker Generates Sgriptabie Applications 

Bowers Development has posted an update For AppMaker 
^12 to generate scriptable applicadons. With this update, 
AppMaker generates the ‘acae’ rcsourc'e, and code lo restJve 
object references, to handle GeiData and SetData events, and to 
create elements. Jliis update supports PowerPluni. In the coming 
weeks we will post updates for our oilier languages. 

Anollier new feature in this update Ls the ability to 
‘^override’’ generated code with your own code. You can 
specify an override name for ihe App, Doc, windows, 
dialogs, or DalaDefs. A|)]:>Maker's generated code will 
instantiate your class in.stead of the standard class. Your 
override class is assumtal to be a subclass of the standard 
class. I.e. your code overrides the standard ct)de. 
http://members.aol.com/bowersdev/LateNews.html. 

VSE Web Site Turbo 3-0.2 

Voget Selbach Enterprises (VSE) announced the release of 
VSE Web Site Tiirlx) 3^0.2. 

VSE Wei) Site Turlxi is a tool that tries to prevent web 
surfers from leaving a web site Ix^fore it has l:>een loaded. 

It <i(x‘s that hy making web pages load as Fast as possible. 
VSE Web Site Turlx) strips unneeded data from web pages, 
re.suking in size reductions averaging from 20 to 30 [percent 
ha.sed on content. It also optimizes JPEG and GIF inxtges. The 
appearanc:e of the w^eb page is not changer!. 

The new version fixes seveial minor bugs and a cotiflict with 
the Palm Desktop Extension that could lead to a crash. It also offers 
a new preferences option that allows the user to filter special files. 
http://vse-online.com/web-site-turbo/‘tndex*html 
http://web5iteturboxom/Progs/web-5ite-turbo.hqx 
hTtp://vse-on line.com/web-site-turbo/download.html 


Automated Solutions Group Announces 
StructNamesPack 

Obtain arrays of method names, ILsl names and form names 
for a given table. 

Automated Solutions Group announced ihe release of 
StructNamesrack, a suite of routines for o[)taining aimys of 
method names, list names, and form names for a given table. 

About StructNaincsRick 

StructName.sPack includes a variety of functions, designed to 
enhance any 4th Dimension application, providing a suite of 
plug-in routines. 

Included in StnictNamesPack are the following features: 

• Build an arniy of 4rh Dimension lists 

• Build an array of Projea MetlK)ds 

• Build an anay of lk>mis for a given 'Fable 

StructNamesPack is avaiial>le for boiii Madnlosh and 
Windows based applications and includes a ’‘no-hassle” license. 
Purchase a single copy of StructNamesl^ack iier developer (per 
platfijnii in which ii will lx‘ u.scd or dcvelo[)cd) within your 
organization and you may use it royalty-fice in an Linlimited 
number of compiled applications. 
http://vvww.asgsoft,com. 

Object rcK)LS Releases Latest Version of Eiffel for 
Maoniosh CodeWarrior 

This is tlic Beta 3 iclea.se and should fie the last beta before 
Final release, (Apple would call it a Golden Master candidate). 

Wtirks on all CW versions fft>m Gold 11 to Pro 3.3- Eiffel for 
Macintosh is now well in Legrated witii the CodeWarrior IDE. The 
speed of the compiler i.s nearly doubled. The compiler now^ 
reports multiple errors instead of stopping on the first. What was 
knowm as the MOTEL library is ntJW' known iLS Lloney. The 
compiler now adds generatecl .c files to the Code group 
correctly, EiflVl projects are Ixiter organized, refitxting the 
.separation of concerns in EilTeL Now .supports die create 
keyword, ratlier than f! (still supported but Hagged). The class 
creators clau.se now prefers the ca*ate keywTjrd rather than 
creation. All know'n bugs have Ix'cn fixed. 
http://www.objea-tools.com/products/eiffel-s/index.html 
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Rip those wire^P 
out of your network. 
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One coll to Winncom Technologies brings 
you complete wireless network solutions. 
Whether you require connectivity in your 
building or across town, we hove 
the right products and the service to keep 
you connected without the wires. 


ll^pmplefie |ihe of wirelp^s netvyork 
l^lorns ^pdiproduc^^ 

|dfi}g;^p<ibuildi ng co n nPcHvity, 


’ Wil^lesl^orkstotions and 
laptops for local area networks 


ryf "v/jfyJyii; lycal 
tJod^Wda isru'j ri2r//orJ'3 

V/irSiJyii; riyiv/arl; dysigri, corj/igyruriorj 
and support sar /icss 


Winncom Technologies' engineers will 
quickly assess your needs and recommend 
the right wireless solution for your application. 

Our commitment to quality service, throughout 

every phase, ensures the success of your project. ■ ■ 

Your partners in wireless network connectivity. 




Winncom 

Technologies 


So go ahead, rip those wires out 
of your network. Just be sure to call 
Winncom Technologies first. 

We'll keep you connected-without the wires. 


1 888-WINNCOM 
440.498.9510 

30700 Cofief Soil® A 
Solon, Ohio 44139 
Sole s^^winncom .com 
WWW. winncorn .com 










CodeWarrlor is the only serious choice 
for professionat Mac^ development. 

Chances are, eveiy Mac program you 
use was created using CndeWarrior In 
fact, more than 90% of all commercial 
Mac OS applications are built with 
CocleWarnor 

Built with the Mac developer in mind. 

1 he Code Warrior Iniegraled Develop¬ 
ment Fnvironment (IDE) has won every 
major award given lu Mac developmcni 
soft ware. It's the worldwide standard for 



Code Utin fjjr fereps you dfietid of the curve 
tindjufurr OS X supfwrt. 


creating Mac software, and coniinues io 

lead the indusiiy 

Check out these CodeWarrior benefils: 

^ 1 he state-of-the-art IDE shorfrns 
your devriopmeiit (iine. 

✓ Evtiything you med in one tax... 
project manager, editor, compilers, 
debuggers, linkers, assemblers, 
profilers, a file compare utility our 
world-class framewoik PowcrPlant7 
and the flexlbduy to ptug-in third 
parly components. 

i/lJse the SCI me /cimifiur touJset 
to develop for all the major 
plat forms, including Windows'^ 
Linux, Solans^ game consoles 
and embedded platlorms. 

* 1 ^ Tightest ISO/IFC C++ slancfurds 
rompfrunre 

✓ C, C++ cifid Java'"suppciH 


fA CodeWarrior 

JLJLjL «... r>c 


metro^v0fks 


Go with the world-class standard. 

Use the same powerful, flexible, 
fa.si toolset that built world-class 
apps like Adobe'" Photoshop*" and 
Netscape"*" Navigator'"' 


See for yourself. 

Don't just lake our word for it. 

Get your PRhE* )0-duy evaluation 
edit ion of CodeWarrior for Mac OS 
and pul It to the tesL 



Discover why aver 

200,000 programmers p|B|i| 
worliiwlde use CodeWarrior. 

Call today or order online 
FREE 30-day evaluation 

wwnv.netrowepks.coiii/ 9 o/mactiH:b 

1.800-377-5416 

'lynr^-retiindftble ^tipping aivd handling ol $ 1.95 
per CO applies, plus slate sales ta^ if applicable. 


Hurry! offer expires 4/30/2000. 



■aspi immi 
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(fiJ 1999-2000 MalrDwerks. All riflrtls fosorvod MeirowflfKs. itt« Moiiowcfks logo and CodeWarrior arQ rugijilured [ratleinaitei. aod PowerPlant is b Iraderraik nt ti^etrowerkiii Inn All other products are Iraderriarits oimeir 
respoolM) companies. ftJi prices are to US dollars: offer yood m US and Canada only, CtxleWariicii lor Mao OS, Professional Editron, tairgets Mac OS and Wiodcrws 95 / 9 &'NI only, otfiei targets availabie separately 



































